Функция GetMenuDefaultItem выясняет заданный по умолчанию пункт в заданном меню.
Синтаксис
UINT GetMenuDefaultItem( HMENU hMenu, UINT fByPos, UINT gmdiFlags ); |
Параметры
hMenu
[in] Дескриптор меню, из которого извлекается заданный по умолчанию пункт меню.fByPos
[in] Устанавливает, либо извлекать идентификатор пункта меню, либо его позицию. Если этот параметр - ЛОЖЬ (FALSE), возвращается идентификатор . В противном случае возвращается позиция.gmdiFlags
[in] Устанавливает, как функция ищет пункты меню. Этот параметр может равняться нулю или одному из ниже следующих значений.
|
Значение |
Предназначение |
|
GMDI_GOINTOPOPUPS |
Определяет то, что если заданный по умолчанию пункт тот, который открывает подменю, функция должна искать рекурсивно в соответствующем подменю. Если подменю не имеет никакого заданного по умолчанию пункта, величина возвращаемого значения идентифицирует пункт, который открывает подменю. По умолчанию, функция возвращает значение первого заданного по умолчанию пункта в определяемом меню, независимо от того, является ли он пунктом, который открывает подменю. |
|
GMDI_USEDISABLED |
Определяет, что функция должна возвратить заданный по умолчанию пункт, даже если он заблокирован. По умолчанию, функция пропускает заблокированные или недоступные пункты. |
Возвращаемые значения
Если функция завершается успешно, величина возвращаемого значения - идентификатор или позиция пункта меню.
Если функция завершается ошибкой, величина возвращаемого значения равна - (минус) 1. Чтобы получить дополнительные сведения об ошибке, вызовите GetLastError.
Смотри также
Краткий обзор Меню, SetMenuDefaultItem
|
Размещение и совместимость GetMenuDefaultItem |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 4.0 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
User32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Winuser.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |