TrackPopupMenuEx

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

(BOOL TrackPopupMenuEx HMENU  hmenu,  UINT  fuFlags,  int  x,  int  y,  HWND  hwnd,  LPTPMPARAMS  lptpm  );
 

Parametrii

hmenu

Ocupa în meniul de comenzi rapide pentru a fi afişate. Acest mâner pot fi obţinute prin apel la funcţia CreatePopupMenu pentru a crea un nou meniu de comenzi rapide sau sunând la funcţia GetSubMenu pentru a prelua ghidajul pentru un submeniu care asociate cu un element de meniu existent.

fuFlags

Poziţionarea şi alte opţiuni. Acest parametru, care poate fi zero sau mai multe dintre valorile listate cu funcţia TrackPopupMenu , pot include, de asemenea, una dintre următoarele valori:

Valoarea	Sensul
TPM_HORIZONTAL	Dacă meniul nu poate fi indicat la loca?ia specificată fără suprapunere dreptunghiului excluse, sistemul încearcă pentru a găzdui alinierea pe orizontală solicitată înainte de alinierea verticală solicitate.
TPM_VERTICAL	Dacă meniul nu poate fi indicat la loca?ia specificată fără suprapunere dreptunghiului excluse, sistemul încearcă pentru a găzdui alinierea verticală solicitată înainte de solicitat alinierea pe orizontală.

Dreptunghiul excluse este o parte de la ecran care meniul nu ar trebui să se suprapună; Acesta este specificat de către lptpm.

x

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

y

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

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 fuFlags , funcţia nu trimite mesaje în fereastra identificate de hwnd. Cu toate acestea, mai aveţi pentru a trece un mâner fereastra în hwnd. Poate fi orice fereastră mâner din aplicaţia.

lptpm

Indicator spre o structură TPMPARAMS care specifică o zona de ecran din meniul nu ar trebui să se suprapună. Acest parametru poate fi NULL.

Valorile întroarse

Dacă specificaţi TPM_RETURNCMD în parametrul fuFlags , 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 fuFlags , 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

TPM_HORIZONTAL

TPM_VERTICAL

Parametrul lptpm trebuie să fie setat NULL.

QuickInfo

nbsp; Windows &NT: necesită versiunea 4.0 sau ulterioară.
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, TPMPARAMS, TrackPopupMenu, WM_COMMAND

Index