TrackPopupMenuEx

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

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

Parametry

hmenu

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

fuFlags

Położenie i inne opcje. Ten parametr, który może być zero lub więcej wartości wymienione z funkcją TrackPopupMenu , również może zawierać jedną z następujących wartości:

Wartość	Znaczenie
TPM_HORIZONTAL	Jeśli menu nie mogą być ukazane w określonej lokalizacji bez nakładania wykluczonych prostokąt, system próbuje pomieścić żądane wyrównanie poziome przed żądane wyrównanie w pionie.
TPM_VERTICAL	Jeśli menu nie mogą być ukazane w określonej lokalizacji bez nakładania wykluczonych prostokąt, system próbuje pomieścić żądane wyrównanie w pionie przed żądane wyrównanie poziome.

Wykluczone prostokąt jest część ekranu, na którym menu nie powinny się nakładać; jest określony przez lptpm.

x

Poziome położenie menu skrótów, zgodnie ze współrzędnymi ekranowymi.

y

Pionowe położenie menu skrótów, zgodnie ze współrzędnymi ekranowymi.

hwnd

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 fuFlags funkcji nie wysyłać wiadomości do okna zidentyfikowane przez hwnd. Jednakże nadal należy przekazać uchwyt okna w hwnd. Może to być dowolny uchwyt okna z aplikacji.

lptpm

Wskaźnik do struktury TPMPARAMS , który określa obszar ekranu, menu nie powinny się nakładać. Ten parametr może mieć wartości NULL.

Zwraca wartości

Jeśli określisz TPM_RETURNCMD w parametrze fuFlags , 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 fuFlags , 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

TPM_HORIZONTAL

TPM_VERTICAL

Parametr lptpm musi być ustawiony na wartość NULL.

Skrócone informacje

nbsp; Windows &NT: wymaga w wersji 4.0 lub nowszej.
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, TPMPARAMS, TrackPopupMenu, WM_COMMAND

Index