(ПолучитьСтрокуМеню)

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

GetMenuString работает, но уже устарела. Вместо нее используйте GetMenuItemInfo.

Синтаксис

int GetMenuString(
	HMENU hMenu,		// дескриптор меню
	UINT uIDItem,		// идентификатор пункта меню
	LPTSTR lpString,		// указатель на буфер для строки
	int nMaxCount,		// максимальная длина строки
	UINT uFlag		// флажки меню
);

Параметры
hMenu
Идентифицирует меню.
uIDItem
Определяет пункт меню, который будет изменен, как обусловлено параметром uFlag.
lpString
Указатель на буфер, который принимает строку с символом нуля в конце. Если строка такой же длины или длиннее чем lpString, строка обрезается и добавляется признак конца ПУСТО (NULL). Если lpString - значение ПУСТО (NULL), функция возвращает длину строки меню.
nMaxCount
Определяет максимальную длину, в символах, строки, которая будет скопирована. Если строка длиннее, чем максимум, определяемый в параметре nMaxCount, лишние символы обрезаются.
Если nMaxCount имеет значение 0, функция возвращает значение длины строки меню.
uFlag
Определяет, как интерпретируется параметр uIDItem. Этот параметр должен быть одним из следующих значений:

• MF_BYCOMMAND - Указывает, что uIDItem дает идентификатор пункта меню. Если ни флажок MF_BYCOMMAND, ни флажок MF_BYPOSITION не установлен, флажок MF_BYCOMMAND является флажком, заданным по умолчанию.
• MF_BYPOSITION - Указывает, что uIDItem дает отсчитываемую от нуля относительную позицию пункта меню.

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

Замечания
Обратите внимание! функция GetMenuString была заменена. Используйте функцию GetMenuItemInfo, чтобы получить текст пункта меню.
Параметр nMaxCount должен быть большим, чем число символов в текстовой строке, чтобы разместить символ завершения строки (ноль-терминатор).
Если nMaxCount - 0, функция возвращает значение длины строки меню.
Обратите внимание!
Параметр lpString - буфер TCHAR, а nMaxCount - длина строки меню в TCHARs. Неправильное изменение размеров этих параметров может стать причиной усечения строки, ведя к возможной потере данных.

Смотри также
GetMenuItemID

Размещение и совместимость GetMenuString

Windows NT			Да 
Win95				Да 
Win32s				Да 
Импортируемая библиотека		user32.lib 
Заголовочный файл			winuser.h 
Unicode				WinNT 
Замечания по платформе		Не имеется