(ОтследитьВыскакивающееМеню)

Функция 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, которая определяет часть экрана, в которой пользователь может выбирать контекстное меню без ее освобождения. Если этот параметр имеет значение ПУСТО (NULL), контекстное меню освобождается, если пользователь щелкает кнопкой мыши вне контекстного меню.

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

Смотри также
CreatePopupMenu, GetSubMenu, RECT, WM_COMMAND

Размещение и совместимость TrackPopupMenu

Windows NT			Да 
Win95				Да 
Win32s				Да 
Импортируемая библиотека		user32.lib 
Заголовочный файл			winuser.h 
Unicode				Нет 
Замечания по платформе		Не имеется