AppendMenu

Die Funktion AppendMenu fügt ein neues Element an das Ende von die angegebene Menüleiste, Drop-Down-Menü, Untermenü oder Kontextmenü. Diese Funktion können Sie den Inhalt, die Darstellung und das Verhalten des Menüelements festlegen.

Die Funktion AppendMenu wurde durch die Funktion InsertMenuItem abgelöst. Noch können AppendMenu, jedoch Sie wenn Sie die erweiterten Features der InsertMenuItem nicht benötigen.

 BOOL AppendMenu) HMENU  hMenu, / / handle zum Menü geändert werdenUINTuFlags, / / Menüpunkt FahnenUINTuIDNewItem, / / Menü-Element-ID oder Handle für Drop-Down-Menü oder UntermenüLPCTSTRLpNewItem / / Menüpunkt Inhalt);

Parameter

hMenu
Behandeln Sie, um die Menüleiste, Drop-Down-Menü, Untermenü oder Kontextmenü geändert werden.
uFlags
Gibt Flags an, die Darstellung und das Verhalten des neuen Menüelements zu steuern. Dieser Parameter kann eine Kombination der Werte in den folgenden Abschnitt "Hinweise" aufgeführt sein.
uIDNewItem
Gibt entweder die ID des neuen Menübefehl oder, wenn der Parameter uFlags auf MF_POPUP, das Handle für das Drop-Down-Menü oder Untermenü festgelegt ist.
lpNewItem
Gibt den Inhalt des neuen Menüelements. Die Auslegung des LpNewItem hängt davon ab, ob der uFlags -Parameter die MF_BITMAP, MF_OWNERDRAW oder MF_STRING Flagge, wie folgt enthält:
Wert Beschreibung
MF_BITMAP Enthält einen Bitmap-handle.
MF_OWNERDRAW Enthält einen 32-Bit-Wert von der Anwendung, die verwendet werden kann, um zusätzliche Daten mit Bezug zum Menüpunkt verwalten bereitgestellte. Der Wert ist im ItemData -Member der Struktur, auf die den Lparam -Parameter, der die WM_MEASURE oder WM_DRAWITEM Nachricht gesendet, wenn das Menü erstellt wird oder sein Erscheinungsbild ist.
MF_STRING Enthält einen Zeiger auf eine Null-terminierte Zeichenkette.

Rückgabewerte

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (null). Rufen Sie Fehlerinformationen verlängert bekommen, GetLastError.

Bemerkungen

Die Anwendung muss der DrawMenuBar -Funktion, wenn ein Menü ändert, rufen, ob in einem angezeigten Fenster das Menü ist.

Um Zugriffstasten arbeiten mit Bitmap oder Ownerdrawn-Menüelemente zu erhalten, muss der Besitzer des Menüs die WM_MENUCHAR Nachricht verarbeiten. Weitere Informationen finden Sie unter Owner-Drawn-Menüs und die WM_MENUCHAR-Nachricht.

Die folgenden Flags sind im uFlags Parameter einstellbar:

Wert Beschreibung
MF_BITMAP Verwendet eine Bitmap als Menüelement. Der LpNewItem -Parameter enthält das Handle für das bitmap.
MF_CHECKED Ein Häkchen neben dem Menüelement platziert. Wenn die Anwendung Häkchen Bitmaps enthält (siehe SetMenuItemBitmaps, diese Flagge zeigt das Häkchen neben dem Menüelement bitmap.
MF_DISABLED Das Menüelement deaktiviert, so dass es kann nicht ausgewählt werden, aber die Flagge wird es nicht grau.
MF_ENABLED Das Menüelement aktiviert, sodass es ausgewählt werden kann, und es vom grauen Zustand stellt.
MF_GRAYED Wird das Menüelement deaktiviert, und es grays, so dass es nicht ausgewählt werden können.
MF_MENUBARBREAK Funktionen kennzeichnen die gleiche wie die MF_MENUBREAK für eine Menüleiste. Für eine Drop-Down-Menü, Untermenü oder Kontextmenü ist die neue Spalte von der alten Spalte durch eine vertikale Linie getrennt.
MF_MENUBREAK Stellt das Element in einer neuen Zeile (für eine Menüleiste) oder in einer neuen Spalte (für ein Drop-Down-Menü, Untermenü oder Kontextmenü) ohne zu trennen von Spalten.
MF_OWNERDRAW Das Element ist ein Ownerdrawn Element angibt. Bevor das Menü zum ersten Mal angezeigt wird, empfängt das Fenster, das das Menü besitzt eine WM_MEASUREITEM -Nachricht, die Breite und Höhe des Menüelements abzurufen. Die WM_DRAWITEM Nachricht wird dann an die Fensterprozedur des Besitzerfensters gesendet, wenn das Aussehen des Menüelements aktualisiert werden muss.
MF_POPUP Gibt an, dass das Menüelement ein Drop-Down-Menü oder ein Untermenü öffnet. Der Parameter uIDNewItem gibt das Handle für das Drop-Down-Menü oder Untermenü. Dieses Flag wird verwendet, um auf einen Menünamen auf einer Menüleiste oder ein Menüelement, das öffnet ein Untermenü für ein Drop-Down-Menü, Untermenü oder Kontextmenü hinzufügen.
MF_SEPARATOR Zeichnet eine horizontale Trennlinie. Dieses Flag wird nur in einer Drop-Down-Menü, Untermenü oder Kontextmenü verwendet. Die Zeile kann nicht grau unterlegt, deaktiviert oder hervorgehoben werden. Die Parameter LpNewItem und uIDNewItem werden ignoriert.
MF_STRING Gibt an, dass das Menüelement eine Textzeichenfolge ist; der LpNewItem -Parameter verweist auf die Zeichenfolge.
MF_UNCHECKED Platzieren Sie ein Häkchen neben dem Element (Standard) nicht. Wenn die Anwendung Häkchen Bitmaps liefert (siehe SetMenuItemBitmaps), zeigt dieses Flag deaktiviert Bitmap neben dem Menüelement.

Die folgenden Gruppen von Flags können nicht zusammen verwendet werden:

Windows CE: Die folgenden Flags sind für den FuFlags -Parameter nicht unterstützt.

MF_BITMAP

MF_DISABLED

MFS_GRAYED

MF_GRAYED kann an Stelle von MF_DISABLED und MFS_GRAYED verwendet werden.

Windows CE 1.0 unterstützt keine Untermenüs. Wenn Sie Windows CE 1.0 verwenden, können nicht Sie eine MF_POPUP Menü in ein anderes Pop-up Menü Einfügen.

In Windows CE 1.0 werden die folgenden Flags nicht unterstützt:

MF_POPUP

MF_MENUBREAK

MF_MENUBARBREAK

Diese Flags werden in Windows CE-Versionen 2.0 und höher unterstützt. Untermenüs werden ebenfalls unterstützt.

Siehe auch

Übersicht über die Menüs, Menü-Funktionen CreateMenu, DeleteMenu, DestroyMenu, DrawMenuBar, InsertMenu, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps

Index