TrackPopupMenuEx

Функція TrackPopupMenuEx показує контекстне меню, в указаному розташуванні та відстежує виділення елементів контекстного меню. У контекстному меню може виникнути будь-де на екрані.

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

Параметри

hmenu

Працювати з контекстне меню для відображення. Цей маркер можуть бути отримані шляхом виклику функції CreatePopupMenu до створення нових контекстного меню або виклику функції GetSubMenu отримати ручку, щоб підменю, пов'язаних з наявного елемента меню.

fuFlags

Позиціонування та інші параметри. Цей параметр, який може бути, нуль або більше значень, у списку з TrackPopupMenu функції, може також містити одне з таких значень:

Значення	Значення
TPM_HORIZONTAL	Якщо меню не відображається в указаному розташуванні без перекриття виключені прямокутник, система намагається розміщення запитаний горизонтальне вирівнювання перед запитаний вертикальне вирівнювання.
TPM_VERTICAL	Якщо меню не відображається в указаному розташуванні без перекриття виключені прямокутник, система намагається розміщення запитаний вертикальне вирівнювання перед запитаний вирівнювання по горизонталі.

Виключені прямокутник становить частину екрана, які не повинні перекриватися меню; Вона визначається lptpm.

x

Горизонтальне розташування з контекстне меню, в екранних координатах.

y

Вертикальне розташування з контекстне меню, в екранних координатах.

hwnd

Ручка вікна, що володіє в контекстному меню. Це вікно отримує всі повідомлення з меню. Вікно не отримує WM_COMMAND повідомлення з меню поки функція повертає.

Якщо вказати TPM_NONOTIFY в параметрі fuFlags , функція не надсилати повідомлення до вікна визначені hwnd. Однак, вам все одно доведеться пройти дескриптор вікна в hwnd. Це може бути будь-який дескриптор вікна від вашого застосування.

lptpm

Вказівник на TPMPARAMS структури, що визначає область екрана меню не повинні перекриватися. Цей параметр може бути NULL.

Повернення значень

Якщо вказати TPM_RETURNCMD в параметрі fuFlags , значення, що повертається є пункт меню ідентифікатор користувача вибраний елемент. Якщо користувач скасував меню без здійснення певного вибору або виникнення помилки, виберіть значення дорівнює нулю.

Якщо не вказати TPM_RETURNCMD в параметрі fuFlags , значення, що повертається є ненульовим, якщо функція вдасться і нуля, якщо вона не зможе. Щоб отримати докладні відомості про помилку, зателефонуйте GetLastError.

Зауваження

Windows CE: Windows CE не підтримує наступні варіанти стану для параметра uFlags

TPM_NONOTIFY

TPM_LEFTBUTTON

TPM_RIGHTBUTTON

TPM_HORIZONTAL

TPM_VERTICAL

Параметр lptpm слід установити значення NULL.

QuickInfo

nbsp; Windows &NT: вимагає 4.0 або пізнішої версії.
Windows:Вимагає Windows 95 або пізнішої версії.
Windows CE:Потрібна Версія 1.0 або пізнішу версію.
Заголовка:Оголошена в winuser.h.
Імпортувати бібліотеки:Використання user32.lib.

Дивіться також

Огляд меню, меню функцій, CreatePopupMenu, GetSubMenu, TPMPARAMS, TrackPopupMenu, WM_COMMAND

Index