CMenu::AppendMenu

BOOL AppendMenu zawsze zwraca ( UINT nFlags, UINT nIDNewItem = 0, LPCTSTR lpszNewItem = NULL );

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

Wartość zwracany

Niezerowa, jeśli funkcja jest skuteczne; inny sposób 0.

Parametry

nFlags

Określa informacje dotyczące stanu nowego elementu menu, gdy jest ono dodawane do menu. Składa się z jednego lub więcej wartości wymienionych w sekcji uwagi.

nIDNewItem

Określa identyfikator polecenia nowego elementu menu lub, jeżeli nFlags jest ustawiona na MF_POPUP, uchwyt menu (HMENU) z menu wyskakującego. Parametr nIDNewItem jest ignorowane (nie jest to konieczne), jeśli nFlags jest ustawiona na MF_SEPARATOR.

lpszNewItem

Określa zawartość nowego elementu menu. Parametr nFlags jest używany do interpretowania lpszNewItem w następujący sposób:

nFlags	Interpretacja lpszNewItem
MF_OWNERDRAW	Zawiera wartość 32-bitowe dostarczone aplikacji, w aplikacji można używać do utrzymywania dodatkowych danych skojarzonych z elementu menu. Ta wartość 32-bitowy jest dostępna do aplikacji podczas przetwarzania wiadomości WM_MEASUREITEM i WM_DRAWITEM . Wartość jest przechowywana w itemData członkiem struktury dostarczonych z tych wiadomości.
MF_STRING	Zawiera wskaźnik na ciąg zakończony znakiem null. To jest interpretacja domyślne.
MF_SEPARATOR	Parametr lpszNewItem jest ignorowany, (zbędny).

pBmp

Punkty do obiektu CBitmap , który będzie używany jako element menu.

Uwagi

Dołącza nowy element do końca menu. Aplikację można określić stan elementu menu przez ustawienie wartości nFlags. NIDNewItem określa wyskakujące menu, staje się częścią menu, do której jest dołączony. Jeśli zniszczenia tego menu, menu dołączany również zostać zniszczone. Dołączone menu powinny być zdjęte z obiektu CMenu w celu uniknięcia konfliktu. Należy zauważyć, że MF_STRING i MF_OWNERDRAW nie są prawidłowe dla wersji bitmapy AppendMenu zawsze zwraca.

Poniższa lista zawiera opis flagi, które mogą być ustawione w nFlags:

MF_CHECKEDnbsp; Działa jako przełącznik z MF_U&NCHECKED do domyślnego znacznika wyboru obok elementu. Jeżeli aplikacji dostarcza bitmapy znacznik wyboru (patrz funkcja Państwa SetMenuItemBitmaps ), mapa bitowa "znacznik wyboru na" jest wyświetlany.
MF_U&NCHECKEDnbsp; Działa jako przełącznik z MF_CHECKED aby usunąć znacznik wyboru obok elementu. Jeżeli aplikacji dostarcza bitmapy znacznik wyboru (patrz funkcja Państwa SetMenuItemBitmaps ), mapa bitowa "znacznik wyboru poza" jest wyświetlany.
MF_DISABLED Wyłącza elementu menu, tak aby nie może być wybrany, ale nie dim.
MF_E&NABLEDnbsp; Umożliwia elementu menu, tak aby można wybrać i przywraca go ze stanu wygaszone.
MF_GRAYED Wyłącza elementu menu, tak aby nie mogą być zaznaczane i powoduje ona.
MF_ME&NUBARBREAKnbsp; Umieszcza element w nowym wierszu statyczne menu lub w nowej kolumnie w wyskakujących menu. Nowa kolumna wyskakującego menu będzie być oddzielony od starych Kolumna pionowa linia podziału.
MF_ME&NUBREAKnbsp; Umieszcza element w nowym wierszu statyczne menu lub w nowej kolumnie w wyskakujących menu. Nie wyraźnej linii jest umieszczony między kolumnami.
MF_OW&NERDRAWnbsp; Określa, że dany zapas jest zapasem rysowania przez właściciela. Po wyświetleniu menu po raz pierwszy okno, w którym posiada menu odbiera komunikat WM_MEASUREITEM , który pobiera wysokość i szerokość elementu menu. Wiadomość WM_DRAWITEM jest wysyłany, gdy właściciel musi zaktualizować wygląd elementu menu. Ta opcja nie jest prawidłowa dla elementu menu najwyższego poziomu.
MF_POPUP Określa, że element menu ma wyskakujące menu skojarzone z nim. Parametr identyfikator Określa dojście do wyskakującego menu, która ma zostać skojarzona z towarem. Służy do dodawania najwyższego poziomu wyskakującego menu lub hierarchiczne menu wyskakującego do elementu menu wyskakującego.
MF_SEPARATOR Rysuje linię podziału poziomego. Może być używany tylko w wyskakującym menu. Ten wiersz nie wygaszone, wyłączony lub wyróżniane. Inne parametry są ignorowane.
MF_STRI&NGnbsp; Określa, że element menu jest ciąg znaków.

Każdy z poniższych grup zawiera flagi, które wzajemnie się wykluczają i nie mogą być używane razem:

MF_DISABLED, MF_ENABLEDi MF_GRAYED
MF_STRING, MF_OWNERDRAW, MF_SEPARATORi wersji bitmapy
MF_MENUBARBREAK i MF_MENUBREAK
MF_CHECKED i MF_UNCHECKED

Gdy menu, w którym znajduje się w oknie zostanie zmieniona (spasane lub nie jest wyświetlane okno), aplikacja powinna wywołać CWnd::DrawMenuBar.

Omówienie CMenu |nbsp; Klasa członków | Wykres hierarchii

Zobacz teżnbsp;CWnd::DrawMenuBar, CMenu::InsertMenu, CMenu::RemoveMenu, CMenu::SetMenuItemBitmaps, CMenu::Detach, :: AppendMenu zawsze zwraca

Index