GetMenuString

GetMenuString функция копирует текстовую строку из указанного пункта меню в указанный буфер.

Функция функция GetMenuString , был заменен. Используйте функцию GetMenuItemInfo для извлечения текста пункта меню.

int () GetMenuString HMENU  hMenu, / / обработать в менюUINTuIDItem, / / меню пункт идентификаторLPTSTRlpString, / / указатель на буфер строкиintnMaxCount, / / максимальная длина строкиUINTuFlag / / флаги меню);
 

Параметры

hMenu
Дескриптор меню.
uIDItem
Определяет пункт меню, чтобы изменить, как определено в параметре uFlag.
lpString
Указатель на буфер для приема строки с завершающим нулем.

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

nMaxCount
Указывает максимальную длину в символах, для копирования. Если строка длиннее максимума, указанного в параметре nMaxCount , лишние символы обрезаются.

Если nMaxCount равно 0, то функция возвращает длину строки меню.

uFlag
Определяет способ интерпретации параметра uIDItem . Этот параметр должен быть одним из следующих значений:
Значение Значение
MF_BYCOMMAND Указывает, что этот uIDItem дает идентификатор элемента меню. Если указано ни MF_BYCOMMAND, ни MF_BYPOSITION флаг, флаг MF_BYCOMMAND — флаг по умолчанию.
MF_BYPOSITION Указывает, что этот uIDItem дает с нуля относительное положение элемента меню.

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

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

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

Примечания

Параметр nMaxCount должен быть один больше, чем количество знаков в текстовой строке для размещения завершающий символ null.

Если nMaxCount равно 0, то функция возвращает длину строки меню.

Родственные слова

Меню Обзор функций меню, GetMenuItemID

Index