InsertMenu

Die InsertMenu -Funktion fügt ein neues Menüelement in einem Menü, andere Elemente nach unten im Menü bewegen.

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

BOOL InsertMenu) HMENU  hMenu, / / handle zum MenüUINTuPosition, / / Menü item das neue Menü Element vorangestellt istUINTuFlags, / / Menüpunkt FahnenUINTuIDNewItem, / / Menü Element-ID oder handle für Dropdown-Listenfeld / / Menü oder UntermenüLPCTSTRLpNewItem / / Menüelement Inhalt);
 

Parameter

hMenu
Handle für das Menü geändert werden.
uPosition
Gibt das Menüelement vor dem neuen Menüpunkt eingefügt werden wie durch den Parameter uFlags bestimmt, soll.
uFlags
Gibt Flags an, die die Auslegung der uPosition -Parameter und die Inhalte, Darstellung und Verhalten des neuen Menüelements zu steuern. Dieser Parameter muss eine Kombination aus den folgenden erforderlichen Werte und mindestens eine der im folgenden Abschnitt "Hinweise" aufgeführten Werte sein.
Wert Beschreibung
MF_BYCOMMAND Gibt an, dass der uPosition -Parameter die ID des Menüelements gibt. Das MF_BYCOMMAND-Flag ist die Standardeinstellung, wenn weder der MF_BYCOMMAND noch das MF_BYPOSITION-Flag angegeben ist.
MF_BYPOSITION Gibt an, dass der uPosition -Parameter die nullbasierte relative Position der neue Menüpunkt gibt. Wenn uPosition 0xFFFFFFFF ist, ist das neue Menüelement am Ende des Menüs angefügt.

uIDNewItem
Gibt entweder die ID des neuen Menübefehl oder, wenn der Parameter uFlags hat das MF_POPUP-Flag gesetzt, das Handle für das Drop-Down-Menü oder Untermenü.
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_MEASUREITEM oder WM_DRAWITEM Nachricht gesendet, wenn das Menüelement erstellt wird oder sein Erscheinungsbild ist.
MF_STRING Enthält einen Zeiger auf eine Null-terminierte Zeichenfolge (Standard).

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.

Die folgende Liste beschreibt die Flags, die in der uFlags -Parameter festgelegt werden können:

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), zeigt dieses Flag die Bitmap Häkchen neben dem Menüelement.
MF_DISABLED Das Menüelement deaktiviert, so dass es kann nicht ausgewählt werden, aber es nicht grau.
MF_ENABLED Das Menüelement aktiviert, so dass 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 Menüleisten) 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 Menüelement (Standard) nicht. Wenn die Anwendung Häkchen Bitmaps liefert (siehe die SetMenuItemBitmaps -Funktion), zeigt dieses Flag deaktiviert Bitmap neben den Menüpunkt.

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

Windows CE: Windows CE unterstützt nicht die MF_BITMAP-Flag oder das MF_DISABLED-Flag in der uFlags -Parameter. Menüelemente können nicht deaktiviert werden, ohne wird grau. Deaktivieren Sie ein Menüelement verwenden Sie das Flag MF_GRAYED.

Windows CE Version 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. Wenn Windows CE 2.0 oder höher verwenden, können Sie.

Siehe auch

Übersicht über die Menüs, Menüfunktionen, AppendMenu, DeleteMenu, DrawMenuBar, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps, WM_DRAWITEM, WM_MEASUREITEM

Index