TrackPopupMenuEx

La funzione TrackPopupMenuEx viene visualizzato un menu di scelta rapida nella posizione specificata e tiene la selezione di elementi di menu di scelta rapida. Menu di scelta rapida può apparire ovunque sullo schermo.

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

Parametri

hmenu

Handle per il menu di scelta rapida per essere visualizzato. Questo handle può essere ottenuto chiamando la funzione CreatePopupMenu per creare un nuovo menu di scelta rapida o chiamando la funzione GetSubMenu per recuperare l'handle a un sottomenu associato a un elemento esistente dal menu.

fuFlags

Posizionamento e altre opzioni. Questo parametro, che può essere zero o più valori elencati con la funzione TrackPopupMenu , può anche includere uno dei seguenti valori:

Valore	Significato
TPM_HORIZONTAL	Se il menu non può essere visualizzato nella posizione specificata senza sovrapposizione del rettangolo escluso, il sistema tenta di ospitare l'allineamento orizzontale richiesto prima l'allineamento verticale richiesto.
TPM_VERTICAL	Se il menu non può essere visualizzato nella posizione specificata senza sovrapposizione del rettangolo escluso, il sistema tenta di ospitare l'allineamento verticale richiesto prima l'allineamento orizzontale richiesto.

Il rettangolo escluso è una porzione di schermo che non deve sovrapporsi il menu; si è specificato da lptpm.

x

Posizione orizzontale del menu di scelta rapida, in coordinate dello schermo.

y

Posizione verticale del menu di scelta rapida, in coordinate dello schermo.

hwnd

Gestire alla finestra che possiede il menu di scelta rapida. Questa finestra riceve tutti i messaggi dal menu. La finestra non riceve un messaggio WM_COMMAND dal menu fino a quando la funzione restituisce.

Se TPM_NONOTIFY viene specificato nel parametro fuFlags , la funzione non invia messaggi nella finestra identificato da hwnd. Tuttavia, ancora necessario passare un handle di finestra hwnd. Può essere qualsiasi handle della finestra dell'applicazione.

lptpm

Puntatore a una struttura TPMPARAMS che specifica un'area dello schermo il menu non deve sovrapporsi. Questo parametro può essere NULL.

Valori restituiti

Se TPM_RETURNCMD viene specificato nel parametro fuFlags , il valore restituito è l'identificatore di voci di menu dell'elemento che l'utente selezionato. Se l'utente annulla il menu senza fare una selezione, o se si verifica un errore, quindi il valore restituito è pari a zero.

Se non si specifica TPM_RETURNCMD nel parametro fuFlags , il valore restituito è diverso da zero se la funzione ha esito positivo e zero se non riesce. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

Windows CE: Windows CE non supporta i seguenti flag per il parametro uFlags

TPM_NONOTIFY

TPM_LEFTBUTTON

TPM_RIGHTBUTTON

TPM_HORIZONTAL

TPM_VERTICAL

Il parametro lptpm deve essere impostato su NULL.

Descrizione

nbsp; Windows &NT: richiede una versione 4.0 o successive.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.

Vedi anche

Panoramica di menu, Menu funzioni, CreatePopupMenu, GetSubMenu, TPMPARAMS, TrackPopupMenu, WM_COMMAND

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index