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