Funzione SetMenuItemBitmaps (winuser.h)

Articolo
08/28/2023

Associa la bitmap specificata a una voce di menu. Se la voce di menu è selezionata o deselezionata, il sistema visualizza la bitmap appropriata accanto alla voce di menu.

Sintassi

BOOL SetMenuItemBitmaps(
  [in]           HMENU   hMenu,
  [in]           UINT    uPosition,
  [in]           UINT    uFlags,
  [in, optional] HBITMAP hBitmapUnchecked,
  [in, optional] HBITMAP hBitmapChecked
);

Parametri

[in] hMenu

Tipo: HMENU

Handle del menu contenente l'elemento per ricevere nuove bitmap di segno di spunta.

[in] uPosition

Tipo: UINT

Voce di menu da modificare, come determinato dal parametro uFlags .

[in] uFlags

Tipo: UINT

Specifica la modalità di interpretazione del parametro uPosition . Il parametro uFlags deve essere uno dei valori seguenti.

Valore	Significato
MF_BYCOMMAND 0x0000000L	Indica che uPosition fornisce l'identificatore della voce di menu. Se non viene specificato né MF_BYCOMMAND néMF_BYPOSITION , MF_BYCOMMAND è il flag predefinito.
MF_BYPOSITION 0x0000400L	Indica che uPosition assegna la posizione relativa in base zero della voce di menu.

[in, optional] hBitmapUnchecked

Tipo: HBITMAP

Handle per la bitmap visualizzata quando la voce di menu non è selezionata.

[in, optional] hBitmapChecked

Tipo: HBITMAP

Handle per la bitmap visualizzata quando viene selezionata la voce di menu.

Valore restituito

Tipo: BOOL

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

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

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

Quando il menu viene eliminato definitivamente, queste bitmap non vengono distrutte; spetta all'applicazione distruggerli.

Le bitmap selezionate e chiare devono essere monocromatiche. Il sistema usa l'operatore AND booleano per combinare bitmap con il menu in modo che la parte bianca diventi trasparente e la parte nera diventi il colore della voce di menu. Se si usano bitmap a colori, i risultati potrebbero non essere desiderati.

Usare la funzione GetSystemMetrics con i valori SM_CXMENUCHECK e SM_CYMENUCHECK per recuperare le dimensioni bitmap.

Esempio

Per un esempio, vedere Simulazione di caselle di controllo in un menu.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll

Condividi tramite