TrackPopupMenu

Funcţia TrackPopupMenu afişează un meniu de comenzi rapide la loca?ia specificată şi urmăreşte selectarea elementelor din meniul. Meniul de comenzi rapide pot apărea oriunde pe ecran.

(BOOL TrackPopupMenu HMENU  hMenu, / / ocupa la meniul de comenzi rapideUINTuFlags, / / ecran-poziţia şi butonul mouse-ului steaguriint x, / / coordonează poziţie orizontală, în ecranulint y, / / coordonează pozi?ia verticală, în ecranul intnReserved, / / rezervate, trebuie să fie zeroHWNDhWnd, / / ocupa proprietarul fereastraCONST RECT* prcRect / / ignorat);
 

Parametrii

hMenu

Ocupa în meniul de comenzi rapide pentru a fi afişate. Mâner poate fi ob?inută prin apelarea CreatePopupMenu pentru a crea un nou meniu de comenzi rapide, sau prin apelarea GetSubMenu pentru a prelua ghidajul pentru un submeniu care asociate cu un element de meniu existent.

uFlags

Un set de steaguri de biţi care specifică funcţia opţiuni.

Utilizaţi una dintre următoarele constante pavilion pic pentru a specifica cum funcţia poziţii din meniul de comenzi rapide pe orizontală.

Valoarea	Sensul
TPM_CENTERALIGN	Dacă acest flag este setată, funcţia centre din meniul de comenzi rapide orizontal faţă coordonate specificat de parametrul x.
TPM_LEFTALIGN	Dacă acest flag este setată, funcţia poziţii din meniul de comenzi rapide, astfel încât partea sa stânga este aliniat cu coordonate specificat de parametrul x.
TPM_RIGHTALIGN	Poziţii din meniul de comenzi rapide, astfel încât partea sa dreaptă este aliniat cu coordonate specificat de parametrul x.

Utilizaţi una dintre următoarele constante pavilion pic pentru a specifica cum funcţia poziţii din meniul de comenzi rapide pe verticală.

Valoarea	Sensul
TPM_BOTTOMALIGN	Dacă acest flag este setată, funcţia poziţii din meniul de comenzi rapide, astfel încât partea sa inferioară este aliniat cu coordonate specificat de parametrul y.
TPM_TOPALIGN	Dacă acest flag este setată, funcţia poziţii din meniul de comenzi rapide, astfel încât partea sa de sus este aliniat cu coordonate specificat de parametrul y.
TPM_VCENTERALIGN	Dacă acest flag este setată, funcţia centre din meniul de comenzi rapide vertical fa?ă de coordonate specificat de parametrul y.

Utilizaţi următoarele constante pavilion pic pentru a determina selecţia user fără să parametrizaţi o fereastră părinte pentru meniul.

Valoarea	Sensul
TPM_NONOTIFY	Dacă acest flag este setată, funcţia nu a trimite mesajele de notificare atunci când utilizatorul face clic pe un element de meniu.
TPM_RETURNCMD	Dacă acest flag este setat, funcţia întoarce identificatorul de articol meniul de selecţie a utilizatorului în valoare returnată.

Utilizarea una dintre următoarele pic de pavilion constante pentru a specifica care mouse butonul liniile meniul de comenzi rapide.

Valoarea	Sensul
TPM_LEFTBUTTON	Dacă acest flag este setată, utilizatorul poate selecta elementele de meniu cu numai butonul stâng al mausului.
TPM_RIGHTBUTTON	Dacă acest flag este setată, utilizatorul poate selecta elementele de meniu cu ambele butoane mouse stânga şi la dreapta.

x

Specifică poziţia orizontală din meniul de comenzi rapide, în coordonate de ecran.

y

Specifică poziţia verticală din meniul de comenzi rapide, în coordonate de ecran.

nReserved

Rezervate; trebuie să fie zero.

hWnd

Ocupa în fereastra care deţine în meniul de comenzi rapide. Această fereastră primeşte toate mesajele din meniul. Fereastra nu primiţi un mesaj de WM_COMMAND din meniul până când funcţia întoarce.

Dacă specificaţi TPM_NONOTIFY în parametrul uFlags , funcţia nu trimite mesaje în fereastra identificate de hWnd. Cu toate acestea, trebuie să treacă încă un mâner fereastra în hWnd. Poate fi orice fereastră mâner din aplicaţia.

prcRect

Ignorat.

Valorile întroarse

Dacă specificaţi TPM_RETURNCMD în parametrul uFlags , valoarea returnată este identificatorul de element de meniu din elementul care utilizatorul selectat. În cazul în care utilizatorul anulează meniul fără a face o selecţie sau dacă survine o eroare, apoi valoarea returnată este zero.

Dacă nu specificaţi TPM_RETURNCMD în parametrul uFlags , valoarea returnată este diferită de zero Dacă funcţia reuşeşte şi zero dacă nu reuşeşte. Pentru a obţine extins informa?ii eroare, apel GetLastError.

Observaţii

Windows CE: Windows CE nu acceptă următoarele semnalizări pentru parametrul uFlags

TPM_NONOTIFY

TPM_LEFTBUTTON

TPM_RIGHTBUTTON

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Necesită versiunea 1.0 sau mai târziu.
Antet:A declarat în winuser.h.
Import Biblioteca:Utilizarea user32.lib.

A se vedea, de asemenea

Meniurile privire de ansamblu, meniul Funcţii, CreatePopupMenu, GetSubMenu, RECT, WM_COMMAND

Index