Menüs (Menüs und andere Ressourcen)

In diesem Abschnitt werden Menüs beschrieben und ihre Verwendung erläutert.

In diesem Abschnitt

Name	BESCHREIBUNG
Informationen zu Menüs	Erläutert Menüs.
Verwenden von Menüs	Stellt Codebeispiele für Aufgaben im Zusammenhang mit Menüs bereit.
Menüreferenz	Enthält die API-Referenz.

Menüfunktionen

Name	BESCHREIBUNG
AppendMenu	Fügt ein neues Element am Ende der angegebenen Menüleiste, des Dropdownmenüs, des Untermenüs oder des Kontextmenüs an. Sie können diese Funktion verwenden, um den Inhalt, die Darstellung und das Verhalten des Menüelements anzugeben.
CheckMenuItem	Legt den Status des Häkchen-Attributs des angegebenen Menüelements auf ausgewählt oder deaktiviert fest.
CheckMenuRadioItem	Überprüft ein angegebenes Menüelement und macht es zu einem Optionselement. Gleichzeitig löscht die Funktion alle anderen Menüelemente in der zugeordneten Gruppe und löscht das Funkelementtypflag für diese Elemente.
CreateMenu	Erstellt ein Menü. Das Menü ist zunächst leer, kann aber mithilfe der Funktionen InsertMenuItem, AppendMenu und InsertMenu mit Menüelementen gefüllt werden.
CreatePopupMenu	Erstellt ein Dropdownmenü, ein Untermenü oder ein Kontextmenü. Das Menü ist zunächst leer. Sie können Menüelemente mithilfe der InsertMenuItem-Funktion einfügen oder anfügen. Sie können auch die InsertMenu-Funktion zum Einfügen von Menüelementen und die AppendMenu-Funktion verwenden, um Menüelemente anzufügen.
DeleteMenu	Löscht ein Element aus dem angegebenen Menü. Wenn das Menüelement ein Menü oder Untermenü öffnet, zerstört diese Funktion das Handle zum Menü oder Untermenü und gibt den vom Menü oder Untermenü verwendeten Arbeitsspeicher frei.
DestroyMenu	Zerstört das angegebene Menü und gibt den Arbeitsspeicher frei, den das Menü belegt.
DrawMenuBar	Zeichnet die Menüleiste des angegebenen Fensters neu aus. Wenn sich die Menüleiste ändert, nachdem das System das Fenster erstellt hat, muss diese Funktion aufgerufen werden, um die geänderte Menüleiste zu zeichnen.
EnableMenuItem	Aktiviert, deaktiviert oder graut das angegebene Menüelement.
EndMenu	Beendet das aktive Menü des aufrufenden Threads.
GetMenu	Ruft ein Handle zum Menü ab, das dem angegebenen Fenster zugewiesen ist.
GetMenuBarInfo	Ruft Informationen zur angegebenen Menüleiste ab.
GetMenuCheckMarkDimensions	Ruft die Abmessungen der Standardmäßig-Häkchenbitbitbit ab. Das System zeigt diese Bitmap neben ausgewählten Menüelementen an. Bevor die SetMenuItemBitmaps-Funktion aufgerufen wird, um die Standardmäßig-Häkchenbitbit für ein Menüelement zu ersetzen, muss eine Anwendung die richtige Bitmapgröße durch Aufrufen von GetMenuCheckMarkDimensions ermitteln.
GetMenuDefaultItem	Bestimmt das Standardmenüelement im angegebenen Menü.
GetMenuInfo	Ruft Informationen zu einem angegebenen Menü ab.
GetMenuItemCount	Ruft die Anzahl der Elemente im angegebenen Menü ab.
GetMenuItemID	Ruft den Menüelementbezeichner eines Menüelements ab, das sich an der angegebenen Position in einem Menü befindet.
GetMenuItemInfo	Ruft Informationen zu einem Menüelement ab.
GetMenuItemRect	Ruft das umgebende Rechteck für das angegebene Menüelement ab.
GetMenuState	Ruft die Menüflags ab, die dem angegebenen Menüelement zugeordnet sind. Wenn das Menüelement ein Untermenü öffnet, gibt diese Funktion auch die Anzahl der Elemente im Untermenü zurück.
GetMenuString	Kopiert die Textzeichenfolge des angegebenen Menüelements in den angegebenen Puffer.
GetSubMenu	Ruft ein Handle in das Dropdownmenü oder Untermenü ab, das vom angegebenen Menüelement aktiviert wird.
GetSystemMenu	Ermöglicht der Anwendung den Zugriff auf das Fenstermenü (auch als Systemmenü oder Steuerelementmenü bezeichnet), um sie zu kopieren und zu ändern.
HiliteMenuItem	Hebt die Hervorhebung eines Elements in einer Menüleiste hervor oder entfernt sie.
InsertMenuItem	Fügt ein neues Menüelement an der angegebenen Position in einem Menü ein.
IsMenu	Bestimmt, ob ein Handle ein Menühandle ist.
LoadMenu	Lädt die angegebene Menüressource aus der ausführbaren Datei (.exe), die einer Anwendung instance zugeordnet ist.
LoadMenuIndirect	Lädt die angegebene Menüvorlage in den Arbeitsspeicher.
MenuItemFromPoint	Bestimmt, welches Menüelement sich ggf. an der angegebenen Position befindet.
ModifyMenu	Ändert ein vorhandenes Menüelement. Diese Funktion wird verwendet, um den Inhalt, die Darstellung und das Verhalten des Menüelements anzugeben.
RemoveMenu	Löscht ein Menüelement oder trennt ein Untermenü vom angegebenen Menü. Wenn das Menüelement ein Dropdownmenü oder Untermenü öffnet, zerstört RemoveMenu das Menü oder dessen Handle nicht, sodass das Menü wiederverwendet werden kann. Bevor diese Funktion aufgerufen wird, sollte die GetSubMenu-Funktion ein Handle im Dropdownmenü oder Untermenü abrufen.
SetMenu	Weist dem angegebenen Fenster ein neues Menü zu.
SetMenuDefaultItem	Legt das Standardmenüelement für das angegebene Menü fest.
SetMenuInfo	Legt Informationen für ein angegebenes Menü fest.
SetMenuItemBitmaps	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.
SetMenuItemInfo	Ändert Informationen zu einem Menüelement.
Trackpopupmenu	Zeigt ein Kontextmenü an der angegebenen Position an und verfolgt die Auswahl der Elemente im Menü nach. Das Kontextmenü kann an einer beliebigen Stelle auf dem Bildschirm angezeigt werden.
TrackPopupMenuEx	Zeigt ein Kontextmenü an der angegebenen Position an und verfolgt die Auswahl der Elemente im Kontextmenü nach. Das Kontextmenü kann an einer beliebigen Stelle auf dem Bildschirm angezeigt werden.

Die folgende Funktion ist veraltet.

Name	BESCHREIBUNG
EinfügenMenü	Fügt ein neues Menüelement in ein Menü ein und verschiebt andere Elemente nach unten im Menü. Hinweis: Die InsertMenu-Funktion wurde durch die InsertMenuItem-Funktion ersetzt. Sie können jedoch weiterhin InsertMenu verwenden, wenn Sie keines der erweiterten Features von InsertMenuItem benötigen.

Menübenachrichtigungen

Name	BESCHREIBUNG
WM_COMMAND	Wird gesendet, wenn der Benutzer ein Befehlselement aus einem Menü auswählt, wenn ein Steuerelement eine Benachrichtigung an das übergeordnete Fenster sendet oder wenn eine Tastenkombination übersetzt wird.
WM_CONTEXTMENU	Informiert ein Fenster darüber, dass der Benutzer im Fenster auf die rechte Maustaste geklickt (mit der rechten Maustaste geklickt hat).
WM_ENTERMENULOOP	Informiert die Standard-Fensterprozedur einer Anwendung, dass eine modale Menüschleife eingegeben wurde.
WM_EXITMENULOOP	Informiert die Standard Fensterprozedur einer Anwendung, dass eine modale Menüschleife beendet wurde.
WM_GETTITLEBARINFOEX	Wird gesendet, um erweiterte Titelleisteninformationen anzufordern. Ein Fenster empfängt diese Meldung über die WindowProc-Funktion.
WM_MENUCOMMAND	Wird gesendet, wenn der Benutzer eine Auswahl aus einem Menü trifft.
WM_MENUDRAG	Wird an den Besitzer eines Drag-and-Drop-Menüs gesendet, wenn der Benutzer ein Menüelement zieht.
WM_MENUGETOBJECT	Wird an den Besitzer eines Drag-and-Drop-Menüs gesendet, wenn der Mauszeiger in ein Menüelement wechselt oder von der Mitte des Elements zum oberen oder unteren Rand des Elements wechselt.
WM_MENURBUTTONUP	Wird gesendet, wenn der Benutzer die rechte Maustaste loslässt, während sich der Cursor auf einem Menüelement befindet.
WM_NEXTMENU	Wird an eine Anwendung gesendet, wenn die NACH-RECHTS- oder NACH-LINKS-TASTE verwendet wird, um zwischen der Menüleiste und dem Systemmenü zu wechseln.
WM_UNINITMENUPOPUP	Wird gesendet, wenn ein Dropdownmenü oder Untermenü zerstört wurde.

Menüstrukturen

Name	BESCHREIBUNG
MDINEXTMENU	Enthält Informationen zum zu aktivierenden Menü.
MENUBARINFO	Enthält Menüleisteninformationen.
MENUEX_TEMPLATE_HEADER	Definiert die Kopfzeile für eine erweiterte Menüvorlage. Diese Strukturdefinition dient nur zur Erklärung. es ist in keiner Standardheaderdatei vorhanden.
MENUEX_TEMPLATE_ITEM	Definiert ein Menüelement in einer erweiterten Menüvorlage. Diese Strukturdefinition dient nur zur Erklärung. es ist in keiner Standardheaderdatei vorhanden.
MENUGETOBJECTINFO	Enthält Informationen zum Menü, in dem sich der Mauscursor befindet.
MENUINFO	Enthält Informationen zu einem Menü.
MENUITEMINFO	Enthält Informationen zu einem Menüelement.
MENUITEMTEMPLATE	Definiert ein Menüelement in einer Menüvorlage.
MENUITEMTEMPLATEHEADER	Definiert die Kopfzeile für eine Menüvorlage. Eine vollständige Menüvorlage besteht aus einer Kopfzeile und einer oder mehreren Menüelementlisten.
TPMPARAMS	Enthält erweiterte Parameter für die TrackPopupMenuEx-Funktion .