Функция GetMenuDefaultItem

Функция 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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz