InsertMenu

Funkcia InsertMenu vloží novú položku menu do ponuky, iné presúvaním nadol v ponuke.

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

BOOL InsertMenu ( HMENU  hMenu; / / zvládnuť menuUINTuPosition; / / ponuky položku Nová ponuka položke predchádzaUINTuFlags; / / flags položka ponukyUINTuIDNewItem; / ponuke položka identifikátor alebo zvládnuť kvapka-down / / ponuka alebo vedľajšia ponukaLPCTSTRlpNewItem / / ponuke položka obsahu);

Parametre

hMenu
Spracovať do ponuky je možné zmeniť.
uPosition
Určuje položka ponuky, pred ktorým novú položku menu je vložená, ako určí uFlags parameter.
uFlags
Určuje príznaky, ktoré riadia výklad parametra uPosition a obsah, vzhľad a správanie novú položku menu. Tento parameter musí byť kombináciou jeden z nasledujúcich požadovaných hodnôt a aspoň jeden z hodnoty uvedené v nasledovnej sekcii poznámky.
Hodnota Popis
MF_BYCOMMAND Označuje, že uPosition parameter dáva identifikátor položky ponuky. MF_BYCOMMAND vlajkou je predvolené, ak je určená ani MF_BYCOMMAND, ani MF_BYPOSITION vlajky.
MF_BYPOSITION Označuje, že uPosition parameter dáva zero-based polohu novú položku menu. Ak uPosition je 0xFFFFFFFF, novú položku menu je pridaný na koniec menu.

uIDNewItem
Určuje identifikátor novú položku menu alebo ak uFlags parameter má MF_POPUP nastavený príznak, 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_MEASUREITEM alebo WM_DRAWITEM správa odoslaná pri vytvorení položky ponuky alebo aktualizovať jej vzhľad.
MF_STRING Obsahuje ukazovateľ na reťazec zakončený (predvolené).

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.

Nasledujúci zoznam popisuje príznaky, ktoré môžete 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čiarknutia bitové mapy (pozri SetMenuItemBitmaps), táto vlajka zobrazí bitová mapa začiarknutia vedľa položky ponuky.
MF_DISABLED Vypne položka ponuky tak, že to nie je možné vybrať, ale nie je sivé to.
MF_ENABLED Umožňuje položka ponuky tak, že 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 s ponukami) 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 na paneli ponuky alebo na položku 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 Neumiestňujte začiarknutia položky ponuky (predvolené). Ak uplatňovanie dodávok začiarknutia bitové mapy (pozri funkciu 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: Windows CE nepodporuje MF_BITMAP vlajku alebo MF_DISABLED vlajku v parametri uFlags . Položky menu nie je možné zakázané bez je sivý. Ak chcete vypnúť položka ponuky použiť príznak MF_GRAYED.

Windows CE verzia 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. Ak používate Windows CE 2.0 alebo novšej, môžete.

Pozri tiež

Ponuky prehľad funkcií Menu, AppendMenu, DeleteMenu, DrawMenuBar, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps, WM_DRAWITEM, WM_MEASUREITEM

Index