TrackPopupMenu

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

BOOL TrackPopupMenu) HMENU  hMenu, / / handle zu im KontextmenüUINTuFlags, / / Bildschirm-Position und Maustaste flagsint x, / / horizontale Position in Bildschirm-Koordinatenint y, / / vertikale Position, in Bildschirm-Koordinaten intnReserved, / / reserviert, muss NULL seinHWNDhWnd, / / handle für Eigentümer FensterCONST RECT* PrcRect / / ignoriert);
 

Parameter

hMenu
Behandeln Sie, um das Kontextmenü angezeigt werden. Das Handle durch Aufrufen von CreatePopupMenu ein neues Kontextmenü erstellen oder durch Aufrufen von GetSubMenu um das Handle zu einem Untermenü eine vorhandene Menüelement zugeordnet abzurufen erhalten Sie.
uFlags
Ein Satz von Bitflags, die Funktion Optionen angeben.

Verwenden Sie eine der die folgenden Bit Flag-Konstanten, die angeben, wie die Funktion im Kontextmenü horizontal positioniert.
Wert Bedeutung
TPM_CENTERALIGN Wenn dieses Flag festgelegt ist, konzentriert sich die Funktion im Kontextmenü Horizontal relativ zu der durch den X -Parameter angegebene Koordinate.
TPM_LEFTALIGN Wenn dieses Flag festgelegt ist, positioniert die Funktion im Kontextmenü so, dass die angegebene durch den Parameter x -Koordinate die linke Seite ausgerichtet ist.
TPM_RIGHTALIGN Im Kontextmenü positioniert so, dass die durch den X -Parameter angegebene Koordinate der rechten Seite ausgerichtet ist.

Verwenden Sie eine der folgenden Konstanten Bit-Flag angeben, wie die Funktion im Kontextmenü vertikal positioniert.
Wert Bedeutung
TPM_BOTTOMALIGN Wenn dieses Flag festgelegt ist, positioniert die Funktion im Kontextmenü so, dass seine Unterseite mit der Koordinate, die y -Parameter angegebenen ausgerichtet ist.
TPM_TOPALIGN Wenn dieses Flag festgelegt ist, positioniert die Funktion im Kontextmenü so, dass die Koordinate, die y -Parameter angegebenen seine Oberseite ausgerichtet wird.
TPM_VCENTERALIGN Wenn dieses Flag festgelegt ist, konzentriert sich die Funktion im Kontextmenü vertikal relativ zur durch den y -Parameter angegebene Koordinate.

Verwenden Sie die folgenden Bit Flag-Konstanten, um die Benutzerauswahl zu bestimmen, ohne dass eine übergeordnete Fenster für das Menü eingerichtet.
Wert Bedeutung
TPM_NONOTIFY Wenn dieses Flag festgelegt ist, wird die Funktion nicht Benachrichtigungen senden klickt der Benutzer auf ein Menüelement.
TPM_RETURNCMD Wenn dieses Flag festgelegt ist, gibt die Funktion den Menü Elementbezeichner für die Auswahl des Benutzers im Rückgabewert.

Verwendung eines der folgenden Bit flag Konstanten, die angeben, welche Maus Taste das Kontextmenü Menü Titel.
Wert Bedeutung
TPM_LEFTBUTTON Wenn dieses Flag festgelegt ist, kann der Benutzer Menüelemente nur mit der linken Maustaste auswählen.
TPM_RIGHTBUTTON Wenn dieses Flag festgelegt ist, kann der Benutzer Menüelemente mit sowohl die linken und rechten Maustasten auswählen.

x
Gibt die horizontale Position des Kontextmenüs, in Bildschirmkoordinaten.
y
Gibt die vertikale Position des Kontextmenüs, in Bildschirmkoordinaten.
nReserved
Vorbehalten; NULL muss sein.
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 im uFlags -Parameter angeben, sendet die Funktion keine Nachrichten zum Fenster, hWndidentifiziert. Allerdings müssen Sie ein Fensterhandle hWndnoch übergeben. Es kann jede Fensterhandle aus Ihrer Anwendung.

prcRect
Ignoriert.

Rückgabewerte

Wenn Sie TPM_RETURNCMD im uFlags -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 TPM_RETURNCMD im uFlags -Parameter nicht 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

QuickInfo

&Nbsp; Windows NT: Version 3.1 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 im Menü Funktionen, CreatePopupMenu, GetSubMenu, RECT, WM_COMMAND

Index