AppendMenu

AppendMenu funkcia pridá novú položku do konca špecifikované ponukami, kvapka-down menu, vedľajšia ponuka alebo kontextovú ponuku. Túto funkciu môžete použiť na určenie obsahu, vzhľad a správanie v menu.

AppendMenu funkcia nebola nahradená funkciu InsertMenuItem . Naďalej môžete používať AppendMenu, avšak ak nepotrebujete žiadne rozšírené funkcie InsertMenuItem.

 BOOL AppendMenu ( HMENU  hMenu; / / zvládnuť ponuky zmeniťUINTuFlags; / / flags položka ponukyUINTuIDNewItem; / / položka ponuky identifikátor alebo s nimi zaobchádzajte rozbaľovacej ponuky alebo vedľajšej ponukyLPCTSTRlpNewItem / / položka ponuky obsah);
 

Parametre

hMenu
Manipulovať s ponukami, kvapka-down menu, vedľajšia ponuka alebo kontextovú ponuku zmeniť.
uFlags
Určuje príznaky na ovládanie vzhľadu a správania systému novú položku menu. Tento parameter môže byť kombináciou hodnoty uvedené v nasledovnej sekcii poznámky.
uIDNewItem
Určuje identifikátor novú položku menu, alebo ak uFlags parameter je nastavený na MF_POPUP, rúčka rozbaľovacej ponuky alebo vedľajšej ponuky.
lpNewItem
Určuje obsah novú položku menu. Závisí od výkladu lpNewItem či uFlags parameter patria MF_BITMAP, MF_OWNERDRAW alebo MF_STRING vlajkou, takto:
Hodnota Popis
MF_BITMAP Obsahuje bitovú mapu rukoväť.
MF_OWNERDRAW Obsahuje 32-bitovú hodnotu poskytnutých aplikácie, ktoré môžu byť použité na udržanie dodatočné údaje týkajúce sa položka ponuky. Hodnota člena itemData štruktúry poukázal na lparam parameter WM_MEASURE alebo WM_DRAWITEM správa odoslaná pri vytvorení menu alebo aktualizovať jej vzhľad.
MF_STRING Obsahuje ukazovateľ na reťazec zakončený nulou.

Note:

Ak funkciu podarí, vrátená hodnota je nenulové.

Ak funkcia zlyhá, vrátená hodnota je nula. Získajte rozšírené informácie o chybách, volajte na číslo GetLastError.

Poznámky

Žiadosť musí volať funkciu DrawMenuBar vždy, keď sa ponuka zmeny, či v ponuke je zobrazené Vokne.

Klávesové skratky na prácu s bitová mapa alebo položky vlastník ťahané menu získate vlastník menu proces WM_MENUCHAR správy. Ďalšie informácie nájdete v časti Owner-Drawn menu a WM_MENUCHAR správu.

Nasledovné príznaky možno nastaviť v parametri uFlags:

Hodnota Popis
MF_BITMAP Použije bitovú mapu ako položka ponuky. LpNewItem parameter obsahuje rúčka bitovej mapy.
MF_CHECKED Umiestni začiarknutie políčka vedľa položky ponuky. Ak aplikácia poskytuje začiarkavacie znamienko bitové mapy (pozri SetMenuItemBitmaps, tento príznak zobrazí začiarknutie políčka bitmapové vedľa položky ponuky.
MF_DISABLED Vypne položka ponuky, takže to nie je možné vybrať, ale vlajkou nie sivý.
MF_ENABLED Umožňuje položka ponuky tak môžu byť vybraté a obnoví zo stavu šedej.
MF_GRAYED Vypne položka ponuky a grays, takže to nie je možné vybrať.
MF_MENUBARBREAK Funkcie rovnaká ako MF_MENUBREAK vlajka na panel s ponukami. Pre kvapka-down menu, vedľajšia ponuka alebo kontextovú ponuku, zvislá čiara nový stĺpec oddelený od starej stĺpec.
MF_MENUBREAK Umiestni príslušný prvok na nový riadok (na paneli ponuky) alebo do nového stĺpca (pre kvapka-down menu, vedľajšia ponuka alebo kontextovú ponuku) bez oddelenie stĺpcov.
MF_OWNERDRAW Určuje, že položka je ťahané vlastníkom tovaru. Predtým, ako prvýkrát je zobrazená ponuka, okno, ktoré vlastní v ponuke dostane správu WM_MEASUREITEM získavať šírka a výška položku ponuky. WM_DRAWITEM správa potom odosiela okno postup vlastník okno kedykoľvek vzhľad položka ponuky sa musia aktualizovať.
MF_POPUP Určuje, že položka ponuky otvorí rozbaľovacej ponuky alebo vedľajšej ponuky. UIDNewItem parameter Určuje popisovač rozbaľovacej ponuky alebo vedľajšej ponuky. Táto vlajka je používaná pridať názov ponuky do ponukami alebo položka ponuky, ktoré sa otvorí vedľajšia ponuka kvapka-down menu, vedľajšia ponuka alebo kontextovú ponuku.
MF_SEPARATOR Nakreslí horizontálne deliaca čiara. Táto vlajka je používaná iba v kvapka-down menu, vedľajšia ponuka alebo v kontextovej ponuke. Riadok nemožno sivý, vypnutá alebo zvýraznené. LpNewItem a uIDNewItem parametre sú ignorované.
MF_STRING Určuje, že položka ponuky je textový reťazec; lpNewItem parameter poukazuje na reťazec.
MF_UNCHECKED Nenachádzal znak začiarknutia vedľa položky (predvolené). Ak uplatňovanie dodávok začiarknutia bitové mapy (pozri SetMenuItemBitmaps), táto vlajka zobrazí nezapísanú bitová mapa vedľa položky ponuky.

Nasledovné skupiny vlajok nemôžu používať spoločne:

Windows CE: Nasledovné príznaky nie sú podporované pre fuFlags parameter

MF_BITMAP

MF_DISABLED

MFS_GRAYED

MF_GRAYED môžete použiť namiesto MF_DISABLED a MFS_GRAYED.

Systém Windows CE 1.0 nepodporuje kaskádových ponukách. Ak pou ívate systém Windows CE 1.0, MF_POPUP ponuku nemôžete vkladať do iného pop-up menu.

V systéme Windows CE 1.0, nasledovné príznaky nie sú podporované:

MF_POPUP

MF_MENUBREAK

MF_MENUBARBREAK

Vo verziách systému Windows CE 2.0 a neskoršie, sú podporované tieto príznaky. Podporované sú aj kaskádových ponukách.

Pozri tiež

Ponuky prehľad funkcií Menu, CreateMenu, DeleteMenu, DestroyMenu, DrawMenuBar, InsertMenu, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps

Index