CMenu::TrackPopupMenuEx

Статья
06/10/2015

Отображает контекстное меню в заданном месте с меню и отслеживает выделение элементов во всплывающем меню.

BOOL TrackPopupMenuEx( 
   UINT fuFlags, 
   int x, 
   int y, 
   CWnd* pWnd, 
   LPTPMPARAMS lptpm 
);

Параметры

fuFlags
Определяет различные функции для расширенного меню. Для списка всех значений и их содержание см. в разделе TrackPopupMenuEx.
x
Задает горизонтальное положение в координатах экрана раскрывающегося меню.
y
Определяет вертикальное положение в координатах экрана верхней части меню на экране.
pWnd
Указатель на меню и всплывающее окно, принимающим сообщения из созданного меню. Это поле может быть любым полем из текущего приложения, но не может быть NULL. При указании TPM_NONOTIFY в параметре fuFlags, то функция не отправляет никаких сообщений в pWnd. Функция должна возвращать для окна указанного в pWnd для получения сообщения WM_COMMAND.
lptpm
Указатель на структуру TPMPARAMS, указывающая область экрана меню не должны перекрываться. Этот параметр может быть NULL.

Возвращаемое значение

При указании TPM_RETURNCMD в параметре fuFlags, то возвращаемое значение идентификатор пункта меню, элемента пользователем. Если пользователь отменяет меню без выделения или если происходит ошибка, то возвращаемое значение равно 0.

Если не указать TPM_RETURNCMD в параметре fuFlags, то возвращаемое значение не равно нулю, если функция завершается успешно, и 0, если он завершается ошибкой. Чтобы получить расширенные сведения об ошибке, вызов GetLastError.

Заметки

Контекстное меню меню плавающей запятой может находиться в любом месте экран. Дополнительные сведения об обработке ошибок создать всплывающее меню см. в разделе TrackPopupMenuEx.