Здравствуйте, уважаемые подписчики. Перед вами очередной выпуск рассылки "WinAPI
на русском".
Сайт рассылки: http://www.winnt.rsm.org.ru. Материалы по Win32 API, C++Builder.
Раздел "WinAPI": http://www.winnt.rsm.org.ru/winapi/winapi.htm
Раздел "C++Builder": http://www.winnt.rsm.org.ru/cbuilder/cbuilder.htm
Раздел "Советы & примеры": http://www.winnt.rsm.org.ru/tipstricks/tipstricks.htm
Перевод
Сегодня вашему вниманию представлен перевод функции TrackPopupMenuEx.
TrackPopupMenuEx
Функция TrackPopupMenuEx отображает меню быстрого вызова (shortcut menu) в указанном
месте экрана и отслеживает выбор пунктов меню. Меню быстрого вызова может появляться
в любом месте экрана.
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 от меню до тех пор,
пока функция не завершит выполнение.
lptpm – указатель на структуру типа TPMPARAMS, которая определяет область экрана,
которую меню не должно перекрывать. Значение этого параметра может быть равно
NULL.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации об
ошибке вызовите функцию GetLastError.
См. также
CreatePopupMenu, GetSubMenu, TPMPARAMS, TrackPopupMenu, WM_COMMAND.
хелп по WinAPI: http://www.winnt.rsm.org.ru/winapi/win32api.exe
С уважением,
ведущий рассылки
Тарас Сорока.
mailto:tnsoroka@online.ru