SetMenuItemBitmaps

La funzione SetMenuItemBitmaps associa la bitmap specificata con una voce di menu. Se la voce di menu è selezionata o deselezionata, il sistema visualizza la bitmap appropriata accanto alla voce di menu.

(BOOL SetMenuItemBitmaps HMENU  hMenu, / / handle al menuUINTuPosition, / / la voce del menu per ricevere nuove immagini bitmapUINTuFlags, / / voce di menu flagsHBITMAPhBitmapUnchecked, / / handle a incontrollato bitmapHBITMAPhBitmapChecked / / handle a bitmap selezionata);
 

Parametri

hMenu
Gestire il menu contiene la voce di ricevere nuove immagini bitmap di segno di spunta.
uPosition
Consente di specificare la voce di menu per essere cambiato, come determinato dal parametro uFlags.
uFlags
Specifica come viene interpretato il parametro uPosition . Il parametro uFlags deve essere uno dei seguenti valori.
Valore Significato
MF_BYCOMMAND Indica che uPosition dà l'identificatore della voce di menu. Se viene specificata né MF_BYCOMMAND né MF_BYPOSITION, MF_BYCOMMAND è il flag predefinito.
MF_BYPOSITION Indica che uPosition dà la posizione relativa in base zero della voce di menu.

hBitmapUnchecked
Gestire alla bitmap visualizzate quando non viene selezionata la voce di menu.
hBitmapChecked
Gestire alla bitmap visualizzate quando è selezionata la voce di menu.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

Se il hBitmapUnchecked o hBitmapChecked è NULL, il sistema visualizza nulla accanto alla voce di menu per lo stato corrispondente. Se entrambi i parametri sono NULL, il sistema visualizza la bitmap di segno di spunta predefinito quando l'elemento è selezionato e rimuove la bitmap quando l'elemento non è selezionato.

Quando il menu è distrutto, queste bitmap non vengono distrutti; è compito dell'applicazione per distruggerli.

Le bitmap checked e unchecked dovrebbero essere in bianco e nero. Il sistema utilizza l'operatore booleano e di combinare le bitmap con il menu affinché la parte bianca diventa trasparente e la parte nera diventa il colore della voce di menu. Se si utilizza il colore bitmap, i risultati possono essere indesiderabili.

Utilizzare la funzione GetSystemMetrics con i valori CXMENUCHECK e CYMENUCHECK per recuperare le dimensioni della bitmap.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Non supportato.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.

Vedi anche

Panoramica di menu, Menu funzioni, GetSystemMetrics

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index