AppendMenu zawsze zwraca

Funkcja AppendMenu zawsze zwraca dołącza nowy element na końcu paska menu określonego, rozwijanego menu, podmenu lub menu skrótów. Ta funkcja służy do określania zawartości, wygląd i zachowanie elementu menu.

Funkcja AppendMenu zawsze zwraca został zastąpiony przez funkcję InsertMenuItem . Można nadal używać AppendMenu zawsze zwraca, jednakże, jeśli nie potrzebujesz wszelkich rozszerzonych funkcji InsertMenuItem.

 (BOOL AppendMenu zawsze zwraca HMENU  hMenu, / / dojście do menu, aby zmienićUINTuFlags, / / flags elementu menuUINTuIDNewItem, / / identyfikator elementu menu lub uchwyt z rozwijanego menu lub podmenuLPCTSTRlpNewItem / / zawartości elementu menu);

Parametry

hMenu

Dojście do paska menu, menu rozwijanego, podmenu lub menu skrótów może zostać zmieniony.

uFlags

Określa flagi do sterowania wyglądem i zachowaniem nowego elementu menu. Ten parametr może być kombinacją wartości podanych w poniższej sekcji uwagi.

uIDNewItem

Określa identyfikator nowego elementu menu lub, jeśli parametr uFlags ma wartość MF_POPUP, uchwyt z rozwijanego menu lub podmenu.

lpNewItem

Określa zawartość nowego elementu menu. Interpretacja lpNewItem zależy od tego, czy parametr uFlags zawiera flagę MF_BITMAP, MF_OWNERDRAW lub MF_STRING, w następujący sposób:

Wartość	Opis
MF_BITMAP	Zawiera uchwyt bitmapy.
MF_OWNERDRAW	Zawiera wartość 32-bitowe, dostarczone przez aplikację, która może służyć do utrzymania dodatkowe dane odnoszące się do elementu menu. Wartość jest członek itemData struktury wskazanym przez parametr fikcyjnymi WM_MEASURE lub WM_DRAWITEM wiadomości wysyłane, kiedy menu jest tworzony lub aktualizowany jego wygląd.
MF_STRING	Zawiera wskaźnik na ciąg zakończony znakiem null.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest różna od zera.

Jeśli funkcja zawiedzie, wartość zwracany jest równa zero. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Aplikacja musi wywołać funkcję DrawMenuBar w każdym przypadku zmiany menu, czy menu jest wyświetlane okno.

Aby uzyskać skróty klawiaturowe do pracy w trybie Bitmapa lub elementy menu rysowania przez właściciela, właściciel menu musi przetworzyć wiadomość WM_MENUCHAR. Aby uzyskać więcej informacji zobacz Owner-Drawn menu i komunikat WM_MENUCHAR.

Następujące flagi można ustawić w parametrze uFlags:

Wartość	Opis
MF_BITMAP	Używa bitmapy jako element menu. Parametr lpNewItem zawiera dojścia do bitmapy.
MF_CHECKED	Umieści znacznik wyboru obok tego elementu menu. Jeśli aplikacja zawiera znacznik wyboru bitmapy (patrz SetMenuItemBitmaps, to Wyświetla flagi bitmapy znacznik wyboru obok tego elementu menu.
MF_DISABLED	Wyłącza elementu menu, więc nie może być wybrany, ale bandery nie szary go.
MF_ENABLED	Umożliwia elementu menu, więc można zaznaczać i przywraca go ze stanu wygaszone.
MF_GRAYED	Wyłącza elementu menu i grays, więc nie może być zaznaczone.
MF_MENUBARBREAK	Funkcje, takie same jak MF_MENUBREAK flagę dla paska menu. W menu rozwijanym, podmenu lub menu skrótów nowa kolumna jest oddzielony od starego kolumny przez linię pionową.
MF_MENUBREAK	Umieszcza element w nowym wierszu (na pasku menu) lub w nowej kolumnie (w menu rozwijanym, podmenu lub menu skrótów) bez oddzielających kolumny.
MF_OWNERDRAW	Określa, że element jest element rysowane przez właściciela. Zanim menu zostanie wyświetlony po raz pierwszy, okna, który jest właścicielem menu odbiera wiadomość WM_MEASUREITEM do pobrania szerokość i wysokość elementu menu. Wiadomość WM_DRAWITEM są następnie wysyłane do procedury okna w oknie właściciela, ilekroć wygląd elementu menu musi być uaktualniany.
MF_POPUP	Określa, że element menu otwiera rozwijanego menu lub podmenu. Parametr uIDNewItem określa uchwyt z rozwijanego menu lub podmenu. Ta flaga jest stosowana, aby dodać nazwy menu na pasku menu lub element menu, który spowoduje otwarcie podmenu w menu rozwijanym, podmenu lub menu skrótów.
MF_SEPARATOR	Rysuje linię podziału poziomego. Ta flaga jest stosowana tylko w rozwijanym menu, podmenu lub menu skrótów. Wiersz nie wyszarzone, wyłączony lub wyróżniane. Parametry lpNewItem i uIDNewItem są ignorowane.
MF_STRING	Określa, że element menu jest ciągiem tekstowym; Parametr lpNewItem wskazuje ciąg.
MF_UNCHECKED	Nie należy umieścić znacznik wyboru obok elementu (domyślnie). Jeżeli aplikacji dostaw bitmapy znacznik wyboru (patrz SetMenuItemBitmaps), ta flaga wyświetla zaznaczone mapę bitową obok elementu menu.

Następujące grupy flag nie mogą być używane razem:

MF_DISABLED, MF_ENABLED i MF_GRAYED
MF_BITMAP, MF_STRING i MF_OWNERDRAW
MF_MENUBARBREAK i MF_MENUBREAK
MF_CHECKED i MF_UNCHECKED

Systemu Windows CE: Następujące flagi nie są obsługiwane dla parametru fuFlags

MF_BITMAP

MF_DISABLED

MFS_GRAYED

MF_GRAYED mogą być używane w miejsce z MF_DISABLED i MFS_GRAYED.

Windows CE 1.0 nie obsługuje kaskadowych menu. Jeśli używasz systemu Windows CE 1.0, nie może wstawić w tym do innego menu wyskakującego menu MF_POPUP.

W systemie Windows CE 1.0 nie są obsługiwane następujące flagi:

MF_POPUP

MF_MENUBREAK

MF_MENUBARBREAK

W wersjach systemu Windows CE 2.0 i nowsze te flagi są obsługiwane. Obsługiwane są również menu kaskadowe.

Zobacz też

Menu omówienie, Funkcje Menu, CreateMenu, DeleteMenu, DestroyMenu, DrawMenuBar, InsertMenu, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps

Index