SetMenuItemBitmaps-Funktion (winuser.h)

Artikel
08/28/2023

Ordnet die angegebene Bitmap einem Menüelement zu. Unabhängig davon, ob das Menüelement ausgewählt oder deaktiviert ist, zeigt das System die entsprechende Bitmap neben dem Menüelement an.

Syntax

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

Parameter

[in] hMenu

Typ: HMENU

Ein Handle für das Menü, das das Element enthält, um neue Häkchen-Bitmaps zu empfangen.

[in] uPosition

Typ: UINT

Das zu ändernde Menüelement, wie durch den uFlags-Parameter bestimmt.

[in] uFlags

Typ: UINT

Gibt an, wie der uPosition-Parameter interpretiert werden soll. Der uFlags-Parameter muss einer der folgenden Werte sein.

Wert	Bedeutung
MF_BYCOMMAND 0x00000000L	Gibt an, dass uPosition den Bezeichner des Menüelements angibt. Wenn weder MF_BYCOMMAND noch MF_BYPOSITION angegeben ist, ist MF_BYCOMMAND das Standardflag.
MF_BYPOSITION 0x00000400L	Gibt an, dass uPosition die nullbasierte relative Position des Menüelements angibt.

[in, optional] hBitmapUnchecked

Typ: HBITMAP

Ein Handle für die Bitmap, die angezeigt wird, wenn das Menüelement nicht ausgewählt ist.

[in, optional] hBitmapChecked

Typ: HBITMAP

Ein Handle für die Bitmap, die angezeigt wird, wenn das Menüelement ausgewählt wird.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn entweder der Parameter hBitmapUnchecked oder hBitmapCheckedNULL ist, zeigt das System neben dem Menüelement für den entsprechenden Überprüfungszustand nichts an. Wenn beide Parameter NULL sind, zeigt das System die standardmäßige Häkchenbitbitte an, wenn das Element ausgewählt ist, und entfernt die Bitmap, wenn das Element nicht ausgewählt ist.

Wenn das Menü zerstört wird, werden diese Bitmaps nicht zerstört. es liegt an der Anwendung, sie zu zerstören.

Die ausgewählten und klaren Bitmaps sollten monochrom sein. Das System verwendet den Booleschen AND-Operator, um Bitmaps mit dem Menü zu kombinieren, sodass der weiße Teil transparent wird und der schwarze Teil zur Menüelementfarbe wird. Wenn Sie Farbbitbitbits verwenden, sind die Ergebnisse möglicherweise nicht erwünscht.

Verwenden Sie die GetSystemMetrics-Funktion mit den SM_CXMENUCHECK - und SM_CYMENUCHECK-Werten , um die Bitmapdimensionen abzurufen.

Beispiele

Ein Beispiel finden Sie unter Simulieren von Kontrollkästchen in einem Menü.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll

Weitere Informationen

Menüs

Freigeben über