Русский справочник по Win32 API
Шрифт:
| Значение | Пояснение |
| MF_BYCOMMAND | Указывет, что uPosition принимает идентификатор пункта меню. Флаг MF_BYCOMMAND явялется флагом по умолчанию, если явно не задан ни флаг MF_BYCOMMAND, ни MF_BYPOSITION. |
| MF_BYPOSITION | Указывает, что uPosition принимает относительную, отсчитываемую |
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
Комментарии
Приложение должно вызвать функцию DrawMenuBar при изменении меню, вне зависимости от того, находится ли меню в отображаемом окне или нет.
См . также
DrawMenuBar, RemoveMenu .
GetMenuCheckMarkDimensions
Функция является устаревшей. Используйте GetSystemMetrics со значениями CXMENUCHECK и CYMENUCHECK для извлечения размеров битового образа.
Функция GetMenuCheckMarkDimensions возвращает размеры битового образа отметки по умолчанию пункта меню. Windows отображает этот битовый образ в пункте меню. Перед вызовом функции SetMenuItemBitmaps для изменения битового образа отметки для пункта меню, приложение должно определить корректный размер образа, вызвав GetMenuCheckMarkDimensions .
LONG GetMenuCheckMarkDimensions ( VOID )
Параметры
Функция не имеет параметров.
Возвращаемые значения
Возвращаемое значение определяет высоту и ширину битового образа отметки по умолчанию в пикселях. Старшее слово содержит высоту, младше слово содержит ширину.
См. также
SetMenuItemBitmaps .
GetMenuItemCount
Функция GetMenuItemCount определяет количество пунктов в указанном меню.
int GetMenuItemCount (
HMENU hMenu // дескриптор меню
);
Параметры
hMenu– определяет дескриптор меню, для которого будет определяться количество пунктов .
Возвращаемые значения
В случае успеха возвращаемое значение определяет количество пунктов в меню.
В случае неудачи возвращается -1. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
См . также
GetMenuItemID .
GetMenuItemID
Функция GetMenuItemID
извлекает идентификатор пункта меню, находящегося в указанной позиции в меню.UINT GetMenuItemID (
HMENU hMenu , // дескриптор меню
int nPos // позиция пункта меню
);
Параметры
hMenu– идентифицирует меню, содержащее пункт меню, идентификатор которого извлекается.
nPos– определяет относительную позицию (отсчет начинается с нуля) пункта меню, идентификатор которого извлекается.
Возвращаемые значения
В случае успеха возвращается идентификатор данного пункта меню.
Если идентификатор меню равен NULL, или указанный пункт меню открывает подменю, возвращается 0 xFFFFFFFF .
См. также
GetMenuItemCount, GetMenuString .
GetMailslotInfo
Функция GetMailslotInfo извлекает информацию об указанном мэйлслоте.
BOOL GetMailslotInfo (
HANDLE hMailslot , // дескриптор мэйлслота
LPDWORD lpMaxMessageSize , // адрес максимального размера сообщения
LPDWORD lpNextSize , // адрес размера следующего сообщения
LPDWORD lpMessageCount , // адрес количества сообщений
LPDWORD lpReadTimeout // адрес тайм - аута чтения
);
Параметры
hMailslot– идентифицирует мэйлслот. Этот дескриптор должна создать функция CreateMailslot .
lpMaxMessageSize– когда функция возвращает управление, указывает на буфер, определяющий максимальный размер письма в байтах, допустимый для этого мэйлслота. Эта величина должна быть больше или равна значению параметра cbMaxMsg функции CreateMailslot , создавшей мэйлслот. Значение параметра может быть равно нулю.
lpNextSize– когда функция возвращает управление, указывает на буфер, определяющий размер следующего письма в байтах. Следующая величина имеет специальное значение:
MAILSLOT_NO_MESSAGE - следующее сообщение отсутствует.
Значение параметра может быть равно нулю.
lpMessageCount– когда функция возвращает управление, указывает на буфер, определяющий количество сообщений, ждущих прочтения. Значение параметра может быть равно нулю.