TrackPopupMenu

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

(BOOL TrackPopupMenu HMENU  hMenu, / / ручка з контекстне менюUINTuFlags, / / розташування зображення і кнопку миші прапориInt x, / / горизонтальну позицію, на екран координуєInt y, / / вертикальну позицію, на екран координує intnReserved, / / захищені, повинні бути нульовимHWNDhWnd, / / ручка власник вікноКОНСТАНТА RECT* prcRect / / ігнорувати);
 

Параметри

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

Скористайтеся одним із наступних констант прапор біт, щоб визначити, як функція позиції у контекстному меню по горизонталі.
Значення Значення
TPM_CENTERALIGN Якщо встановлено цю позначку, функцію центрів у контекстному меню горизонтально по відношенню до координат, зазначеного параметра x.
TPM_LEFTALIGN Якщо цей прапор, функція позиції в контекстному меню, так що його ліву сторону відповідність з координат, зазначеного параметра x.
TPM_RIGHTALIGN Позиції в контекстному меню, так що його права сторона відповідність з координат, зазначеного параметра x.

Скористайтеся одним із наступних констант прапор біт, щоб визначити, як функція позиції у контекстному меню по вертикалі.
Значення Значення
TPM_BOTTOMALIGN Якщо встановлено цю позначку, функцію позиції у контекстному меню, щоб його нижній стороні відповідність з координат, вказаний параметр y.
TPM_TOPALIGN Якщо цей прапор, функція позиції в контекстному меню, так що його верхній стороні відповідність з координат, вказаний параметр y.
TPM_VCENTERALIGN Якщо встановлено цю позначку, функцію центрів у контекстному меню вертикально по відношенню до координат, вказаний параметр y.

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

Використання одного з наступних біт прапор константи, щоб визначити, яку миша кнопка контекстного меню треки.
Значення Значення
TPM_LEFTBUTTON Якщо цей прапор, можна вибрати пункти меню з тільки ліву кнопку миші.
TPM_RIGHTBUTTON Якщо цей прапор, можна вибрати пункти меню з обох лівою та правою кнопками.

x
Визначає горизонтальне розташування з контекстне меню, в екранних координатах.
y
Визначає вертикальне розташування з контекстне меню, в екранних координатах.
nReserved
Захищені; повинні бути нульовим.
hWnd
Ручка вікна, що володіє в контекстному меню. Це вікно отримує всі повідомлення з меню. Вікно не отримує WM_COMMAND повідомлення з меню поки функція повертає.

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

prcRect
Ігноруються.

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

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

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

Зауваження

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

TPM_NONOTIFY

TPM_LEFTBUTTON

TPM_RIGHTBUTTON

QuickInfo

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

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

Огляд меню, меню функції, CreatePopupMenu, GetSubMenu, RECT, WM_COMMAND

Index