CMenu::AppendMenu

BOOL AppendMenu ( UINT nFlags, UINT nIDNewItem = 0, LPCTSTR LpszNewItem = NULL );

BOOL AppendMenu ( UINT nFlags, UINT nIDNewItem, const CBitmap * pBmp );

Rückgabewert

Ungleich NULL, wenn die Funktion erfolgreich ist; andernfalls 0.

Parameter

nFlags

Gibt Informationen über den Zustand des neuen Menüelements, wenn es zum Menü hinzugefügt wird. Es besteht aus einem oder mehreren Werten aufgeführt im Abschnitt "Hinweise".

nIDNewItem

Gibt die Befehls-ID für das neue Menüelement oder, wenn nFlags MF_POPUP, das Menü-Handle (HMENU) des ein Popup-Menü festgelegt ist. Der nIDNewItem -Parameter wird (nicht erforderlich) ignoriert, wenn Sie MF_SEPARATOR nFlags festgelegt ist.

lpszNewItem

Gibt den Inhalt des neuen Menüelements. Des nFlags -Parameters wird verwendet, um LpszNewItem auf folgende Weise interpretieren:

nFlags Interpretation der lpszNewItem
MF_OWNERDRAW Enthält einen Anwendung bereitgestellte 32-Bit-Wert, den die Anwendung verwenden kann, um zusätzliche Daten zugeordnet Menüpunkt pflegen. Diese 32-Bit-Wert ist für die Anwendung verfügbar, wenn es WM_MEASUREITEM und WM_DRAWITEM -Meldungen verarbeitet. Der Wert wird in die ItemData Member der Struktur geliefert mit diesen Nachrichten gespeichert.
MF_STRING Enthält einen Zeiger auf eine Null-terminierte Zeichenfolge. Dies ist die Standardinterpretation.
MF_SEPARATOR Der LpszNewItem -Parameter wird ignoriert (nicht erforderlich).

pBmp

Punkte auf einer CBitmap -Objekt, das als das Menüelement verwendet wird.

Bemerkungen

Fügt ein neues Element an das Ende eines Menüs. Die Anwendung kann den Zustand des Menüelements angeben, indem Sie Werte in nFlags. Wenn nIDNewItem ein Popup-Menü gibt, wird es Teil des Menüs an das es angefügt ist. Wenn das Menü zerstört ist, wird das angefügte Menü auch zerstört werden. Eine angefügte Menü sollte getrennt werden, aus einem CMenu -Objekt, um Konflikte zu vermeiden. Beachten Sie, dass MF_STRING und MF_OWNERDRAW nicht gültig für die Bitmap-Version des AppendMenu sind.

Die folgende Liste beschreibt die Flags, die in nFlags festgelegt werden kann:

Jeder der folgenden Gruppen enthält Flags, die schließen sich gegenseitig aus und können nicht zusammen verwendet werden:

Wenn ein Menü, das in einem Window befindet (ob oder nicht das Fenster angezeigt wird) geändert wird, sollte die Anwendung CWnd::DrawMenuBar aufrufen.

Übersicht über die CMenu |nbsp; Member der Klasse | Hierarchiediagramm

Siehe auch&Nbsp;CWnd::DrawMenuBar, CMenu::InsertMenu, CMenu::RemoveMenu, CMenu::SetMenuItemBitmaps, CMenu::Detach, :: AppendMenu

Index