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

MF_DISABLED, MF_ENABLED şi MF_GRAYED
MF_BITMAP, MF_STRING şi MF_OWNERDRAW
MF_MENUBARBREAK şi MF_MENUBREAK
MF_CHECKED şi MF_UNCHECKED

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