Функция GetMenuDefaultItem (winuser.h)

  • Статья

Определяет пункт меню по умолчанию в указанном меню.

Синтаксис

UINT GetMenuDefaultItem(
  [in] HMENU hMenu,
  [in] UINT  fByPos,
  [in] UINT  gmdiFlags
);

Параметры

[in] hMenu

Тип: HMENU

Дескриптор меню, для которого извлекается элемент меню по умолчанию.

[in] fByPos

Тип: UINT

Указывает, следует ли получить идентификатор элемента меню или его положение. Если этот параметр имеет значение FALSE, возвращается идентификатор. В противном случае возвращается позиция.

[in] gmdiFlags

Тип: UINT

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

Значение Значение
GMDI_GOINTOPOPUPS
0x0002L
 Если элемент по умолчанию открывает подменю, функция выполняет рекурсивный поиск в соответствующем подменю. Если в подменю нет элемента по умолчанию, возвращаемое значение определяет элемент, открывающий подменю. По умолчанию функция возвращает первый элемент по умолчанию в указанном меню независимо от того, является ли это элементом, открывающим подменю.
GMDI_USEDISABLED
0x0001L
 Функция возвращает элемент по умолчанию, даже если он отключен. По умолчанию функция пропускает отключенные или серые элементы.

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

Тип: UINT

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

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

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll
Набор API ext-ms-win-ntuser-menu-l1-1-0 (появилось в Windows 8)

См. также раздел

Основные понятия

Меню

Справочные материалы

SetMenuDefaultItem