CMenu::TrackPopupMenuEx

Artikel
06/10/2015

Zeigt ein unverankertes Popupmenü an der angegebenen Position an und verfolgt die Auswahl von Elementen im Popupmenü.

BOOL TrackPopupMenuEx( 
   UINT fuFlags, 
   int x, 
   int y, 
   CWnd* pWnd, 
   LPTPMPARAMS lptpm 
);

Parameter

fuFlags
Gibt verschiedene Funktionen zum erweiterte Menü an. Eine Liste aller Werte und ihrer Wichtigkeit, finden Sie unter TrackPopupMenuEx.
x
Gibt die Position in Bildschirmkoordinaten des Popupmenüs an.
y
Gibt die vertikale Position in Bildschirmkoordinaten am Anfang des Menüs auf dem Bildschirm an.
pWnd
Ein Zeiger auf das Fenster das Popupmenü besitzend und Nachrichten vom Menü Empfangen von erstellt haben. Dieses Fenster kann, jedes Fenster von der aktuellen Anwendung sein kann jedoch nicht NULL sein. Wenn Sie TPM_NONOTIFY im fuFlags-Parameter angeben, sendet die Funktion keine Nachrichten zu pWnd. Die Funktion muss für das Fenster zurückkehren, das auf durch pWnd angezeigt wird, auf die WM_COMMAND Nachricht empfangen.
lptpm
Zeiger auf eine TPMPARAMS-Struktur, die einen Bereich des Bildschirms das Menü angibt, sollte nicht überschneiden. Dieser Parameter kann NULL sein.

Rückgabewert

Wenn Sie TPM_RETURNCMD im fuFlags-Parameter angeben, ist der Rückgabewert der Menüelementbezeichner des Elements, das der Benutzer ausgewählt hat. Wenn der Benutzer das Menü abgebrochen werden, ohne eine Auswahl zu machen oder wenn ein Fehler auftritt, ist der Rückgabewert 0.

Wenn Sie nicht TPM_RETURNCMD im fuFlags-Parameter angeben, ist der Rückgabewert ungleich 0 (null), wenn die Funktion und 0 folgt, wenn sie fehlschlägt. Um erweiterte Fehlerinformationen abzurufen, rufen Sie GetLastError auf.

Hinweise

Ein unverankertes Popupmenü kann überall auf dem Bildschirm angezeigt. Weitere Informationen zum Behandeln von Fehlern, wenn Sie das Kontextmenü erstellen, finden Sie unter TrackPopupMenuEx.