InsertMenu

Funcția InsertMenu introduce un element de meniu nou într-un meniu, alte elemente de care se deplasează în jos din meniul.

Funcția InsertMenu a fost înlocuit de funcția InsertMenuItem . Puteți utiliza în continuare InsertMenu, cu toate acestea, în cazul în care nu aveți nevoie de orice caracteristici extinse ale InsertMenuItem.

(BOOL InsertMenu HMENU  hMenu, / / ocupa la meniuUINTuPosition, / / meniul punctul acel meniu nou element precedeUINTuFlags, / / element de meniu steaguriUINTuIDNewItem, / meniul punctul identificator sau ocupa de la drop-jos / / meniu sau submeniuLPCTSTRlpNewItem / / meniul element conținut);
 

Parametrii

hMenu
Ocupa în meniul să fie schimbat.
uPosition
Specifică elementul de meniu, înainte de care elementul de meniu nou este se introduce, în conformitate cu parametrul uFlags.
uFlags
Specifică steaguri care controlează interpretare parametrul uPosition conținut, aspect, și comportamentul noi elementului de meniu. Acest parametru trebuie să fie o combinație de una dintre următoarele valori necesar și cel puțin una dintre valorile listate în secțiunea de comentarii următoarele.
Valoarea Descriere
MF_BYCOMMAND Indică faptul că parametrul uPosition oferă identificatorul elementului de meniu. Pavilionul MF_BYCOMMAND este implicit dacă nu este specificat nici MF_BYCOMMAND, nici MF_BYPOSITION pavilion.
MF_BYPOSITION Indică faptul că parametrul uPosition oferă zero-based poziția relativă a elementului de meniu nou. În cazul în care uPosition este 0xFFFFFFFF, elementul de meniu nou este adăugat la sfârșitul a meniului.

uIDNewItem
Specifică fie identificatorul de elementul de meniu nou sau, dacă parametrul uFlags are setați pavilion MF_POPUP, mâner drop-jos meniu sau submeniu.
lpNewItem
Specifică conținutul nou elementului de meniu. Interpretarea lpNewItem depinde dacă parametrul uFlags include MF_BITMAP, MF_OWNERDRAW sau MF_STRING de pavilion, după cum urmează:
Valoarea Descriere
MF_BITMAP Conține un mâner bitmap.
MF_OWNERDRAW Conține o valoare de 32-bit furnizate de către aplicația care pot fi folosite pentru a menține date suplimentare referitoare la elementul de meniu. Valoarea este membru itemData structura a subliniat de parametrul lparam de WM_MEASUREITEM sau WM_DRAWITEM mesaj trimis atunci când elementul de meniu este creată sau este actualizată aspectul său.
MF_STRING Conține un indicator spre un șir null-terminated (implicit).

Valorile întroarse

Dacă funcția reușește, valoarea returnată este nenul.

Dacă funcția nu reușește, valoarea returnată este zero. Pentru a obține extins informa?ii eroare, apel GetLastError.

Observații

Cererea trebuie să apela funcția de DrawMenuBar ori de câte ori un meniu se modifică, dacă este sau nu din meniul într-o fereastră afișată.

Lista următoare descrie steagurile care pot fi setate în parametrul uFlags:

Valoarea Descriere
MF_BITMAP Utilizează un bitmap ca elementul de meniu. Parametrul lpNewItem conține ghidajul în bitmap.
MF_CHECKED Plasează un marcaj de selectare lângă elementul de meniu. Dacă aplicarea oferă bitmap-uri marcaj (a se vedea SetMenuItemBitmaps), acest pavilion afișează bitmap de marcaj de selectare lângă la elementul de meniu.
MF_DISABLED Dezactivează elementul de meniu, astfel încât aceasta nu poate fi selectată, dar nu gri a.
MF_ENABLED Permite elementul de meniu, astfel încât să pot fi selectate și se restaurează la starea gri.
MF_GRAYED Dezactivează elementul de meniu și Crawley Town este astfel încât aceasta nu poate fi selectată.
MF_MENUBARBREAK Funcții la fel ca MF_MENUBREAK de pavilion pentru o bară de meniu. Pentru un drop-jos meniu, submeniu, sau meniul de comenzi rapide, coloana nou este separate din coloana vechi de o linie verticală.
MF_MENUBREAK Plasează elementul la o nouă linie (pentru bare de meniu) sau într-o coloană nou (pentru un drop-jos meniu, submeniu, sau meniul de comenzi rapide) fără separare coloane.
MF_OWNERDRAW Precizează că elementul este un element-trase de proprietar. Înainte de pentru prima dată este afișat meniul, fereastra care deține meniul primește un mesaj WM_MEASUREITEM pentru a prelua lățimea și înălțimea elementului de meniu. Mesajul WM_DRAWITEM apoi este trimis la procedura fereastra din fereastra proprietarul ori de câte ori trebuie să fie actualizate aspectul elementul de meniu.
MF_POPUP Precizează că elementul de meniu deschide un drop-jos meniu sau submeniu. Parametrul uIDNewItem specifică ghidajul drop-jos meniu sau submeniu. Acest flag este utilizat pentru a adăuga un nume de meniu la o bară de meniuri sau un element de meniu care se deschide un submeniu drop-jos meniu, submeniu, sau meniul de comenzi rapide.
MF_SEPARATOR Desenează o linie despărțitoare orizontală. Acest flag este utilizat numai în drop-jos meniu, submeniu, sau meniul de comenzi rapide. Linia nu poate fi gri, dezactivat, sau subliniat. Parametrii lpNewItem și uIDNewItem sunt ignorate.
MF_STRING Precizează că elementul de meniu este un șir de text; parametrul lpNewItem puncte la șirul.
MF_UNCHECKED Nu plasați un marcaj lângă la elementul de meniu (implicit). Dacă cererea furnizează bitmap-uri marcaj (a se vedea funcția SetMenuItemBitmaps ), acest pavilion afișează bitmap unchecked lângă la elementul de meniu.

Următoarele grupe de steaguri nu pot fi utilizate împreună:

Windows CE: Windows CE nu acceptă pavilion MF_BITMAP sau MF_DISABLED de pavilion în parametrul uFlags . Elemente de meniu nu poate fi dezactivată fără fiind gri. Pentru a dezactiva un element de meniu utilizați pavilion MF_GRAYED.

Windows CE versiunea 1.0 nu acceptă cascading meniuri. Dacă utilizați Windows CE 1.0, nu se poate insera un meniu MF_POPUP în alt meniu pop-up. Dacă utilizați Windows CE 2.0 sau o versiune ulterioară, puteți.

A se vedea, de asemenea

Meniurile privire de ansamblu, meniul Funcții, AppendMenu, DeleteMenu, DrawMenuBar, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps, WM_DRAWITEM, WM_MEASUREITEM

Index