TrackPopupMenuEx

De functie TrackPopupMenuEx wordt een snelmenu weergegeven op de opgegeven locatie en tracks de selectie van items in het snelmenu. Het snelmenu kan overal worden weergegeven op het scherm.

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

Parameters

hmenu
Ingang naar het snelmenu moet worden weergegeven. Dit handvat kan worden verkregen door het aanroepen van de functie CreatePopupMenu een nieuwe snelmenu maken of door de functie GetSubMenu om op te halen de greep aan een vervolgmenu een bestaande menu-item is gekoppeld.
fuFlags
Positionering en andere opties. Deze parameter, die kan nul of meer van de waarden in de lijst met de TrackPopupMenu functie, kan ook een van de volgende waarden bevatten:
Waarde Betekenis
TPM_HORIZONTAL Als het menu niet getoond worden op de opgegeven locatie zonder overlappende de uitgesloten rechthoek, probeert het systeem voor de gevraagde horizontale uitlijning voordat de gevraagde verticale uitlijning.
TPM_VERTICAL Als het menu niet getoond worden op de opgegeven locatie zonder overlappende de uitgesloten rechthoek, probeert het systeem voor de gevraagde verticale uitlijning voordat de gevraagde horizontale uitlijning.

De uitgesloten rechthoek is een gedeelte van het scherm dat het menu niet overlappen moet; het is opgegeven door lptpm.

x
Horizontale locatie van het snelmenu in schermco÷rdinaten.
y
Verticale locatie van het snelmenu in schermco÷rdinaten.
hwnd
Ingang naar het venster dat eigenaar is van het snelmenu. Dit venster vervolgens alle berichten ontvangt van het menu. Het venster ontvangt niet een WM_COMMAND -bericht van het menu totdat de functie weer.

Als u TPM_NONOTIFY in de parameter fuFlags opgeeft , verzendt de functie geen berichten naar het venster ge´dentificeerd door hwnd. Echter, je moet nog steeds een vensteringang in hwnddoorgeven. Het kan zijn een vensteringang van uw toepassing.

lptpm
Aanwijzer naar een TPMPARAMS structuur die een gebied van het scherm het menu aangeeft moet niet overlappen. Deze parameter kan worden NULL.

Retourwaarden

Als u TPM_RETURNCMD in de parameter fuFlags opgeeft , wordt met de retourwaarde de menu-item-id van het item dat de gebruiker geselecteerd is. Als de gebruiker het menu zonder een optie te selecteren annuleert, of als een fout optreedt, dan is de retourwaarde nul.

Als u geen TPM_RETURNCMD in de parameter fuFlags opgeeft , is de geretourneerde waarde dan nul als de functie slaagt en nul als het mislukt. Te krijgen uitgebreide foutinformatie, Bel GetLastError.

Opmerkingen

Windows CE: Windows CE biedt geen ondersteuning voor de volgende vlaggen voor de parameter uFlags

TPM_NONOTIFY

TPM_LEFTBUTTON

TPM_RIGHTBUTTON

TPM_HORIZONTAL

TPM_VERTICAL

De parameter lptpm moet worden ingesteld op NULL.

Syntaxisinfo

nbsp;áWindows &NT: versie 4.0 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Versie 1.0 of hoger vereist.
Header:Verklaard in winuser.h.
Bibliotheek importeren:User32.lib gebruiken.

Zie ook

Overzicht van de menu's, menufuncties, CreatePopupMenu, GetSubMenu, TPMPARAMS, TrackPopupMenu, WM_COMMAND

Index