AppendMenu

Funcția AppendMenu adaugă un element la sfârșitul bara de meniu specificate, drop-jos meniu, submeniu, sau meniul de comenzi rapide. Puteți utiliza această funcție pentru a specifica conținutul, aspectul și comportamentul elementul de meniu.

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

 (BOOL AppendMenu HMENU  hMenu, / / ocupa de meniu să fie schimbatUINTuFlags, / / element de meniu steaguriUINTuIDNewItem, / / identificator element de meniu sau mâner pentru a drop-jos meniu sau submeniuLPCTSTRlpNewItem / / conținutul elementului de meniu);
 

Parametrii

hMenu
Mâner pentru bara de meniu, drop-jos meniu, submeniu, sau meniul de comenzi rapide pentru a fi schimbat.
uFlags
Specifică semnalizări pentru a controla aspectul și comportamentul noi elementului de meniu. Acest parametru poate fi o combinație de valori enumerate în secțiunea următoarele observații.
uIDNewItem
Specifică fie identificatorul de elementul de meniu nou sau, dacă parametrul uFlags este setat la 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_MEASURE sau WM_DRAWITEM mesaj trimis când meniul este creată sau este actualizată aspectul său.
MF_STRING Conține un indicator spre un șir null-terminated.

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ă.

Pentru a obține acceleratoare de tastatură pentru a lucra cu bitmap sau elemente de meniu-trase de proprietar, proprietarul a meniului trebuie să prelucreze mesaj WM_MENUCHAR. Pentru mai multe informații, consultați Owner-Drawn meniuri și mesajul WM_MENUCHAR.

Steagurile următoarele 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ă imagini bitmap marcaj (a se vedea SetMenuItemBitmaps, acest pavilion afișează marcajul de selectare bitmap lângă la elementul de meniu.
MF_DISABLED Dezactivează elementul de meniu, astfel încât aceasta nu poate fi selectată, dar pavilion gri nu este.
MF_ENABLED Permite elementul de meniu așa că 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 o bară 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ă elementul (implicit). Dacă cererea furnizează imagini bitmap marcaj (a se vedea 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: Steagurile următoarele nu sunt acceptate pentru parametrul fuFlags

MF_BITMAP

MF_DISABLED

MFS_GRAYED

MF_GRAYED poate fi utilizat în loc de MF_DISABLED și MFS_GRAYED.

Windows CE 1.0 nu acceptă cascading meniuri. Dacă utilizați Windows CE 1.0, nu inserați un meniu MF_POPUP în alt meniu pop-up.

În Windows CE 1.0, nu sunt acceptate următoarele steagurile:

MF_POPUP

MF_MENUBREAK

MF_MENUBARBREAK

În versiunile de Windows CE 2.0 și mai târziu, aceste semnalizări sunt acceptate. Meniuri cascadă sunt acceptate, de asemenea.

A se vedea, de asemenea

Meniurile privire de ansamblu, meniul Funcții, CreateMenu, DeleteMenu, DestroyMenu, DrawMenuBar, InsertMenu, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps

Index