TrackPopupMenuEx

Die Funktion TrackPopupMenuEx zeigt ein Kontextmenü an der angegebenen Position und die Auswahl von Elementen im Kontextmenü verfolgt. Im Kontextmenü kann überall auf dem Bildschirm angezeigt werden.

BOOL TrackPopupMenuEx) HMENU  Hmenu,  UINT  FuFlags,  Int  X,  Int  y,  HWND  Hwnd,  LPTPMPARAMS  Lptpm  );
 

Parameter

hmenu

Behandeln Sie, um das Kontextmenü angezeigt werden. Dieses Handle kann durch Aufrufen der Funktion CreatePopupMenu ein neues Kontextmenü erstellen oder durch Aufrufen der Funktion GetSubMenu das Handle für ein Untermenü mit einem vorhandenen Menüelement verbundenen abrufen abgerufen werden.

fuFlags

Positionierung und andere Optionen. Dieser Parameter, der NULL oder mehr der aufgeführten mit der TrackPopupMenu -Funktion Werte sein kann, kann auch einen der folgenden Werte enthalten:

Wert	Bedeutung
TPM_HORIZONTAL	Wenn das Menü an der angegebenen Position angezeigt werden kann nicht ohne Überlappung des ausgeschlossenen Rechtecks, versucht das System die angeforderte horizontale Ausrichtung vor die angeforderte vertikale Ausrichtung aufnehmen.
TPM_VERTICAL	Falls das Menü an der angegebenen Position angezeigt werden kann ohne Überlappung des ausgeschlossenen Rechtecks, versucht das System die angeforderte vertikale Ausrichtung vor die angeforderte horizontale Ausrichtung anzupassen.

Das ausgeschlossene Rechteck ist ein Teil des Bildschirms, die im Menü nicht überlappen sollten; Es wird durch Lptpm angegeben.

x

Horizontale Position des Kontextmenüs, in Bildschirmkoordinaten.

y

Vertikale Position des Kontextmenüs, in Bildschirmkoordinaten.

hwnd

Handle für das Fenster, das das Kontextmenü besitzt. In diesem Fenster empfängt alle Nachrichten aus dem Menü. Das Fenster erhält keine WM_COMMAND -Nachricht aus dem Menü bis die Funktion zurückgibt.

Wenn Sie TPM_NONOTIFY in der FuFlags -Parameter angeben, sendet die Funktion keine Nachrichten zum Fenster, Hwndidentifiziert. Jedoch müssen Sie noch ein Fensterhandle Hwndübergeben. Es kann jede Fensterhandle aus Ihrer Anwendung.

lptpm

Zeiger auf eine TPMPARAMS -Struktur, die einen Bereich des Bildschirms das Menü gibt sollten sich nicht überschneiden. Dieser Parameter kann NULL sein.

Rückgabewerte

Wenn Sie TPM_RETURNCMD in der FuFlags -Parameter angeben, wird der Rückgabewert der Menüpunkt Bezeichner für das Element, das der Benutzer ausgewählt. Wenn der Benutzer das Menü abbricht, ohne eine Auswahl treffen, oder wenn ein Fehler auftritt, ist der Rückgabewert 0 (null).

Wenn Sie nicht TPM_RETURNCMD in der FuFlags -Parameter angeben, ist der Rückgabewert ungleich NULL, wenn die Funktion erfolgreich ist und NULL, wenn es fehlschlägt. Rufen Sie Fehlerinformationen verlängert bekommen, GetLastError.

Bemerkungen

Windows CE: Windows CE unterstützt nicht die folgenden Flags für den Parameter uFlags

TPM_NONOTIFY

TPM_LEFTBUTTON

TPM_RIGHTBUTTON

TPM_HORIZONTAL

TPM_VERTICAL

Der Lptpm -Parameter muss auf NULL festgelegt werden.

QuickInfo

&Nbsp; Windows NT: Version 4.0 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Version 1.0 oder höher benötigt.
Header:In winuser.h deklarierten.
Importieren Bibliothek:Verwenden Sie user32.lib.

Siehe auch

Übersicht über die Menüs, Menüfunktionen, CreatePopupMenu, GetSubMenu, TPMPARAMS, TrackPopupMenu, WM_COMMAND

Index