TrackPopupMenu

Funkcja TrackPopupMenu wyświetla menu skrótów w określonej lokalizacji i śledzi wyboru elementów menu. Menu skrótów można się gdziekolwiek na ekranie.

(BOOL TrackPopupMenu HMENU  hMenu, / / dojście do menu skrótówUINTuFlags, / / ekran położenie i przycisk myszy flagiint x, / / współrzędne poziome stanowiska, na ekranieint y, / / współrzędne pionowe położenie, na ekranie intnReserved, / / zarezerwowane, musi być równe zeroHWNDhWnd, / / dojście do okna właścicielaStała RECT* prcRect / / ignorowane);

Parametry

hMenu

Dojście do menu skrótów mają być wyświetlane. Uchwyt można uzyskać przez wywołanie CreatePopupMenu utworzyć nowe menu skrótów lub przez wywołanie GetSubMenu aby pobrać dojścia do podmenu skojarzone z istniejący element menu.

uFlags

Zestaw flag bitowych, które określają opcje funkcji.

Użyj jednej z następujących stałych flagi bitowe do określenia, w jaki sposób funkcja pozycje menu skrótów poziomo.

Wartość Znaczenie

TPM_CENTERALIGN Jeśli ta flaga będzie ustawiona, funkcja Wyśrodkowuje menu skrótów poziomo względem współrzędnych określonej przez parametr x.

TPM_LEFTALIGN Jeśli ta flaga będzie ustawiona, funkcja pozycje menu skrótów, tak, aby jej po lewej stronie jest wyrównany do współrzędnych określonej przez parametr x.

TPM_RIGHTALIGN Pozycje menu skrótów, dzięki czemu jego prawej stronie jest wyrównany do współrzędnych określonej przez parametr x.

Wartość	Znaczenie
TPM_CENTERALIGN	Jeśli ta flaga będzie ustawiona, funkcja Wyśrodkowuje menu skrótów poziomo względem współrzędnych określonej przez parametr x.
TPM_LEFTALIGN	Jeśli ta flaga będzie ustawiona, funkcja pozycje menu skrótów, tak, aby jej po lewej stronie jest wyrównany do współrzędnych określonej przez parametr x.
TPM_RIGHTALIGN	Pozycje menu skrótów, dzięki czemu jego prawej stronie jest wyrównany do współrzędnych określonej przez parametr x.

Użyj jednej z następujących stałych flagi bitowe do określenia, w jaki sposób funkcja pozycje menu skrótów pionowo.

Wartość Znaczenie

TPM_BOTTOMALIGN Jeśli ta flaga będzie ustawiona, funkcja pozycje menu skrótów, tak, aby jej dolnym rogu jest wyrównany do współrzędnych określonej przez parametr y.

TPM_TOPALIGN Jeśli ta flaga będzie ustawiona, funkcja pozycje menu skrótów, tak, aby jego górnej stronie jest wyrównany do współrzędnych określonej przez parametr y.

TPM_VCENTERALIGN Jeśli ta flaga będzie ustawiona, funkcja Wyśrodkowuje menu skrótów pionowo względem współrzędnych określonej przez parametr y.

Wartość	Znaczenie
TPM_BOTTOMALIGN	Jeśli ta flaga będzie ustawiona, funkcja pozycje menu skrótów, tak, aby jej dolnym rogu jest wyrównany do współrzędnych określonej przez parametr y.
TPM_TOPALIGN	Jeśli ta flaga będzie ustawiona, funkcja pozycje menu skrótów, tak, aby jego górnej stronie jest wyrównany do współrzędnych określonej przez parametr y.
TPM_VCENTERALIGN	Jeśli ta flaga będzie ustawiona, funkcja Wyśrodkowuje menu skrótów pionowo względem współrzędnych określonej przez parametr y.

Użyj następujących stałych flagi bitowe ustalenie wybór użytkownika bez konieczności konfigurowania okno nadrzędne dla menu.

Wartość Znaczenie

TPM_NONOTIFY Jeśli ta flaga będzie ustawiona, funkcję nie wysyłać komunikaty powiadamiające, gdy użytkownik kliknie element menu.

TPM_RETURNCMD Jeśli ta flaga będzie ustawiona, funkcja zwraca identyfikator elementu menu wybór użytkownika w wartości zwracanej.

Wartość	Znaczenie
TPM_NONOTIFY	Jeśli ta flaga będzie ustawiona, funkcję nie wysyłać komunikaty powiadamiające, gdy użytkownik kliknie element menu.
TPM_RETURNCMD	Jeśli ta flaga będzie ustawiona, funkcja zwraca identyfikator elementu menu wybór użytkownika w wartości zwracanej.

Użyj jednego z następujących bitowe Flaga stałych do określenia, które myszy przycisk utwory menu skrótów.

Wartość Znaczenie

TPM_LEFTBUTTON Jeśli ta flaga będzie ustawiona, użytkownik może wybrać elementy menu tylko przycisk lewy.

TPM_RIGHTBUTTON Jeśli ta flaga będzie ustawiona, użytkownik może wybrać elementy menu z zarówno przyciski prawym i lewym przyciskiem myszy.

x

Określa lokalizację poziomy w menu skrótów, zgodnie ze współrzędnymi ekranowymi.

y

Określa położenie w pionie w menu skrótów, zgodnie ze współrzędnymi ekranowymi.

nReserved

Zarezerwowane; musi mieć wartość zero.

hWnd

Wartość	Znaczenie
TPM_LEFTBUTTON	Jeśli ta flaga będzie ustawiona, użytkownik może wybrać elementy menu tylko przycisk lewy.
TPM_RIGHTBUTTON	Jeśli ta flaga będzie ustawiona, użytkownik może wybrać elementy menu z zarówno przyciski prawym i lewym przyciskiem myszy.

Dojście do okna, który jest właścicielem w menu skrótów. W tym oknie odbiera wszystkie wiadomości z menu. Okno nie otrzymać wiadomość WM_COMMAND z menu dopóki funkcja zwraca.

Jeśli określisz TPM_NONOTIFY w parametrze uFlags funkcji nie wysyłać wiadomości do okna zidentyfikowane przez hWnd. Jednak musi nadal przechodzi uchwyt okna w hWnd. Może to być dowolny uchwyt okna z aplikacji.

prcRect

Ignorowane.

Zwraca wartości

Jeśli określisz TPM_RETURNCMD w parametrze uFlags , wartość zwracany jest identyfikatorem elementu menu elementu, wybrany przez użytkownika. Jeśli użytkownik anuluje menu bez dokonywania wyboru lub jeśli wystąpi błąd, następnie zwracana wartość wynosi zero.

Jeśli nie określisz TPM_RETURNCMD w parametrze uFlags , wartość zwracany jest niezerowa, jeśli funkcja zakończy się pomyślnie i wartość zero, jeśli nie udaje się. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Systemu Windows CE: Windows CE nie obsługuje następujące flagi dla parametru uFlags

TPM_NONOTIFY

TPM_LEFTBUTTON

TPM_RIGHTBUTTON

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Użycie user32.lib.

Zobacz też

Menu omówienie, Funkcje Menu, CreatePopupMenu, GetSubMenu, RECT, WM_COMMAND

Index