TrackPopupMenu

La funzione TrackPopupMenu di visualizzare un menu di scelta rapida nella posizione specificata e tracce di selezione di articoli sul menu. Menu di scelta rapida può apparire ovunque sullo schermo.

(BOOL TrackPopupMenu HMENU  hMenu, / / handle al menu di scelta rapidaUINTuFlags, / / posizione sullo schermo e il pulsante del mouse flagsint x, / / coordinate di posizione orizzontale, nella schermataint y, / / coordinate di posizione verticale, nella schermata intnReserved, / / riservato, deve essere zeroHWNDhWnd, / / handle di finestra proprietariaCONST RECT* prcRect / / ignorato);
 

Parametri

hMenu

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

uFlags

Un insieme di flag di bit che specificare opzioni di funzione.

Utilizzare una delle seguenti costanti bit bandiera per specificare come la funzione posiziona il menu di scelta rapida in orizzontale.

Valore	Significato
TPM_CENTERALIGN	Se questo flag è impostato, la funzione centra orizzontalmente rispetto alla coordinata specificato dal parametro x menu di scelta rapida.
TPM_LEFTALIGN	Se questo flag è impostato, la funzione posiziona il menu di scelta rapida in modo che il lato sinistro è allineato con la coordinata specificata dal parametro x.
TPM_RIGHTALIGN	Posiziona il menu di scelta rapida, in modo che il lato destro è allineato con la coordinata specificata dal parametro x.

Utilizzare una delle seguenti costanti bit bandiera per specificare come la funzione posiziona il menu di scelta rapida in verticale.

Valore	Significato
TPM_BOTTOMALIGN	Se questo flag è impostato, la funzione posiziona il menu di scelta rapida in modo che la parte inferiore è allineato con la coordinata specificata dal parametro y.
TPM_TOPALIGN	Se questo flag è impostato, la funzione posiziona il menu di scelta rapida in modo che il lato superiore è allineato con la coordinata specificata dal parametro y.
TPM_VCENTERALIGN	Se questo flag è impostato, la funzione centra verticalmente rispetto alla coordinata specificata dal parametro y menu di scelta rapida.

Utilizzare le seguenti costanti bandiera di bit per determinare la selezione dell'utente senza dover impostare una finestra padre per il menu.

Valore	Significato
TPM_NONOTIFY	Se questo flag è impostato, la funzione non invia i messaggi di notifica quando l'utente fa clic su una voce di menu.
TPM_RETURNCMD	Se questo flag è impostato, la funzione restituisce l'identificatore di elemento dal menu di selezione dell'utente nel valore restituito.

Uso uno di seguenti bit bandiera costanti per specificare quale topo pulsante le tracce dal menu di scelta rapida.

Valore	Significato
TPM_LEFTBUTTON	Se questo flag è impostato, l'utente può selezionare le voci di menu con solo il pulsante sinistro del mouse.
TPM_RIGHTBUTTON	Se questo flag è impostato, l'utente può selezionare le voci di menu con entrambi i tasti destro e sinistro del mouse.

x

Specifica la posizione orizzontale del menu di scelta rapida, in coordinate dello schermo.

y

Specifica la posizione verticale del menu di scelta rapida, in coordinate dello schermo.

nReserved

Riservati; deve essere zero.

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 uFlags , la funzione non invia messaggi nella finestra identificato da hWnd. Tuttavia, deve ancora passare un handle di finestra in hWnd. Può essere qualsiasi handle della finestra dell'applicazione.

prcRect

Ignorato.

Valori restituiti

Se TPM_RETURNCMD viene specificato nel parametro uFlags , 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 uFlags , 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

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
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, RECT, WM_COMMAND

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

Index