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);
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. |
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.
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:
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.
Menu omówienie, Funkcje Menu, CreateMenu, DeleteMenu, DestroyMenu, DrawMenuBar, InsertMenu, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps