TrackPopupMenu

Funksjonen TrackPopupMenu viser en hurtigmeny på den angitte plasseringen og sporer valg av elementer på menyen. Hurtigmenyen kan vises hvor som helst på skjermen.

BOOL TrackPopupMenu) HMENU  hMenu, / / håndtere til hurtigmenyenUINTuFlags, / / skjermen-posisjon og museknappen flagsInt x, / / Vannrett posisjon, i skjermen koordinaterInt y, / / vertikal posisjon, i skjermen koordinater intnReserved, / / reservert, må være nullHWNDhWnd, / / håndtere til eiervinduetCONST RECT* prcRect / / ignorert);

Parametere

hMenu

Håndtere på hurtigmenyen skal vises. Håndtaket kan fås ved å kalle CreatePopupMenu Hvis du vil opprette en ny snarvei-meny, eller ved å ringe GetSubMenu Hvis du vil hente en referanse til en undermeny som er knyttet til en eksisterende menyelementet.

uFlags

Et sett med Bitflagg som angir funksjonen alternativer.

Bruk en av følgende bit flagg konstanter til å angi hvordan funksjonen plasserer hurtigmenyen vannrett.

Verdi Betydning

TPM_CENTERALIGN Hvis dette flagget er angitt, Midtstiller funksjonen hurtigmenyen vannrett i forhold til koordinat angitt av parameteren x.

TPM_LEFTALIGN Hvis dette flagget er angitt, plasserer funksjonen hurtigmenyen slik at venstre side er på linje med koordinat angitt av parameteren x.

TPM_RIGHTALIGN Plasserer hurtigmenyen slik at høyre side er på linje med koordinat angitt av parameteren x.

Verdi	Betydning
TPM_CENTERALIGN	Hvis dette flagget er angitt, Midtstiller funksjonen hurtigmenyen vannrett i forhold til koordinat angitt av parameteren x.
TPM_LEFTALIGN	Hvis dette flagget er angitt, plasserer funksjonen hurtigmenyen slik at venstre side er på linje med koordinat angitt av parameteren x.
TPM_RIGHTALIGN	Plasserer hurtigmenyen slik at høyre side er på linje med koordinat angitt av parameteren x.

Bruk en av følgende bit flagg konstanter til å angi hvordan funksjonen plasserer hurtigmenyen loddrett.

Verdi Betydning

TPM_BOTTOMALIGN Hvis dette flagget er angitt, plasserer funksjonen hurtigmenyen slik at høykant bunnen er på linje med koordinat angitt av parameteren y.

TPM_TOPALIGN Hvis dette flagget er angitt, plasserer funksjonen hurtigmenyen slik at dens oversiden er på linje med koordinat angitt av parameteren y.

TPM_VCENTERALIGN Hvis dette flagget er angitt, Midtstiller funksjonen hurtigmenyen loddrett i forhold til koordinat angitt av parameteren y.

Verdi	Betydning
TPM_BOTTOMALIGN	Hvis dette flagget er angitt, plasserer funksjonen hurtigmenyen slik at høykant bunnen er på linje med koordinat angitt av parameteren y.
TPM_TOPALIGN	Hvis dette flagget er angitt, plasserer funksjonen hurtigmenyen slik at dens oversiden er på linje med koordinat angitt av parameteren y.
TPM_VCENTERALIGN	Hvis dette flagget er angitt, Midtstiller funksjonen hurtigmenyen loddrett i forhold til koordinat angitt av parameteren y.

Bruk følgende bit flagg konstanter til å bestemme brukervalg uten å måtte konfigurere et overordnet vindu for menyen.

Verdi Betydning

TPM_NONOTIFY Hvis dette flagget er angitt, sende funksjonen ikke varselmeldinger når brukeren klikker på et menyelement.

TPM_RETURNCMD Hvis dette flagget er angitt, returnerer funksjonen menyen vare-IDen av hva brukeren velger i returverdien.

Verdi	Betydning
TPM_NONOTIFY	Hvis dette flagget er angitt, sende funksjonen ikke varselmeldinger når brukeren klikker på et menyelement.
TPM_RETURNCMD	Hvis dette flagget er angitt, returnerer funksjonen menyen vare-IDen av hva brukeren velger i returverdien.

Bruk en av følgende bit flagge konstanter du vil angi som mus knappen snarvei meny-spor.

Verdi Betydning

TPM_LEFTBUTTON Hvis dette flagget er angitt, kan brukeren velge menypunktene med bare venstre museknapp.

TPM_RIGHTBUTTON Hvis dette flagget er angitt, kan brukeren velge menypunktene med både venstre og høyre museknappene.

x

Angir Horisontal plassering av hurtigmenyen i skjermkoordinater.

y

Angir den vertikale plasseringen for hurtigmenyen i skjermkoordinater.

nReserved

Reservert; må være null.

hWnd

Verdi	Betydning
TPM_LEFTBUTTON	Hvis dette flagget er angitt, kan brukeren velge menypunktene med bare venstre museknapp.
TPM_RIGHTBUTTON	Hvis dette flagget er angitt, kan brukeren velge menypunktene med både venstre og høyre museknappene.

Håndtere til vinduet som eier hurtigmenyen. Dette vinduet mottar alle meldinger fra menyen. Vinduet får ikke en WM_COMMAND -melding fra menyen til funksjonen returnerer.

Hvis du angir TPM_NONOTIFY i parameteren uFlags , sender ikke funksjonen meldinger til vinduet identifisert av hWnd. Du må imidlertid fortsatt sende en vindus-handle i hWnd. Det kan være en hvilken som helst vindusreferanse fra programmet.

prcRect

Ignorert.

Returverdier

Hvis du angir TPM_RETURNCMD i parameteren uFlags , er verdien som returneres den menyelement IDen til elementet som valgt av brukeren. Hvis brukeren avbryter på menyen uten å gjøre et valg, eller hvis det oppstår en feil, deretter er returverdien null.

Hvis du ikke angir TPM_RETURNCMD i parameteren uFlags , er returverdien ikke-null hvis funksjonen er vellykket, og null hvis den mislykkes. Til å vise utvidet feilinformasjon, kan du ringe GetLastError.

Merknader

Windows CE: Windows CE støtter ikke følgende flagg for parameteren uFlags

TPM_NONOTIFY

TPM_LEFTBUTTON

TPM_RIGHTBUTTON

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Krever versjon 1.0 eller senere.
Topptekst:Deklarert i winuser.h.
Importere biblioteket:Bruk user32.lib.

Se også

Oversikt over menyene, menyen fungerer, CreatePopupMenu, GetSubMenu, RECT, WM_COMMAND

Index