На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

TrackPopupMenu



The TrackPopupMenu function displays a shortcut menu at the specified location and tracks the selection of items on the menu. The shortcut menu can appear anywhere on the screen.

BOOL TrackPopupMenu(

HMENU hMenu, // handle of shortcut menu
UINT uFlags, // screen-position and mouse-button flags
int x, // horizontal position, in screen coordinates
int y, // vertical position, in screen coordinates
int nReserved, // reserved, must be zero
HWND hWnd, // handle of owner window
CONST RECT *prcRect // points to RECT that specifies no-dismissal area
);


Parameters

hMenu

Identifies the shortcut menu to be displayed. The handle can be obtained by calling CreatePopupMenu to create a new shortcut menu, or by calling GetSubMenu to retrieve the handle of a submenu associated with an existing menu item.

uFlags

A set of bit flags that specify function options.
Use one of the following bit flag constants to specify how the function positions the popup menu horizontally:

Value Meaning
TPM_CENTERALIGN If this flag is set, the function centers the shortcut menu horizontally relative to the coordinate specified by the x parameter.
TPM_LEFTALIGN If this flag is set, the function positions the shortcut menu so that its left side is aligned with the coordinate specified by the x parameter.
TPM_RIGHTALIGN Positions the shortcut menu so that its right side is aligned with the coordinate specified by the x parameter.


Use one of the following bit flag constants to specify which mouse button the shortcut menu tracks:

Value Meaning
TPM_LEFTBUTTON If this flag is set, the shortcut menu tracks the left mouse button.
TPM_RIGHTBUTTON If this flag is set, the shortcut menu tracks the right mouse button


x

Specifies the horizontal location of the shortcut menu, in screen coordinates.

y

Specifies the vertical location of the shortcut menu, in screen coordinates.

nReserved

Reserved; must be zero.

hWnd

Identifies the window that owns the shortcut menu. This window receives all messages from the menu. The window does not receive a WM_COMMAND message from the menu until the function returns.

prcRect

Points to a RECT structure that specifies the portion of the screen in which the user can select without dismissing the shortcut menu. If this parameter is NULL, the shortcut menu is dismissed if the user clicks outside the shortcut menu.



Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

See Also

CreatePopupMenu, GetSubMenu, RECT, WM_COMMAND


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

TrackPopupMenu



Функция TrackPopupMenu отображает сокращенное меню в определенной позиции и прослеживает выбор пунктов в меню. Сокращенное меню может появиться везде на экране.

BOOL TrackPopupMenu(

HMENU hMenu, // РУЧКА сокращенного меню UINT uFlags, // экранная-позиция и мышь-кнопка флагов int x, // горизонтальная позиция, в экранных координатах int y, // вертикальная позиция, в экранных координатах int nReserved, // зарезервированное, должно быть нулем HWND hWnd, // ручкой окна владельца CONST RECT *точки prcRect // на RECT, которые не определяют никакую-область отказа
);


Параметры

hMenu

Идентифицирует сокращенное меню, которое нужно отображаться. Ручка может быть получена вызовом CreatePopupMenu, чтобы создавать новое сокращенное меню, или вызывая GetSubMenu, чтобы извлекать ручку субменю связанного существующим пунктом меню.

uFlags

Установка бита сигнализирует, что определяет функциональные опции.
Используйте одну из констант битового флага следующего, чтобы определять как функция позиционирует меню высвечивания горизонтально:

Значение Величины
TPM_CENTERALIGN Если этот флаг установлен, функция центрирует сокращенное меню горизонтально относительно координаты определенной x параметром.
TPM_LEFTALIGN Если этот флаг установлен, функция позиционирует сокращенное меню чтобы левая сторона была выровнена координатой определенной x параметром.
TPM_RIGHTALIGN Позиционирует сокращенное меню чтобы сторона права была выровнена координатой определенной x параметром.


Используйте одну из констант битового флага следующего, чтобы определять какой кнопке мыши сокращенные дорожки меню:

Значение Величины
TPM_LEFTBUTTON Если этот флаг установлен, сокращенное меню прослеживает левую кнопку мыши.
TPM_RIGHTBUTTON Если этот флаг установлен, сокращенное меню прослеживает кнопку мыши права


x

Определяет горизонтальную позицию сокращенного меню, в экранных координатах.

y

Определяет вертикальную позицию сокращенного меню, в экранных координатах.

nReserved

Зарезервированное; должно - нулевым.

hWnd

Идентифицирует окно, которое обладает сокращенным меню. Это окно получает все сообщения из меню. Окно не получает сообщение WM_COMMAND из меню пока функция не возвращается.

prcRect

Точки на структуру RECT, которые определяют часть экрана в котором пользователь может не выбраться распуская сокращенное меню. Если этот параметр НЕДЕЙСТВИТЕЛЕН, сокращенное меню распущено если пользователь щелкает за пределами сокращенного меню.



Обратные Величины

Если функция добивается успеха, обратная величина ненулевая.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, вызовите GetLastError.

Смотри Также

CreatePopupMenu, GetSubMenu, RECT, WM_COMMAND


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz