Поделиться через


CMenu::GetMenuString

Копирует метка указанной точки меню в заданный буфер.

int GetMenuString(
   UINT nIDItem,
   LPTSTR lpString,
   int nMaxCount,
   UINT nFlags 
) const;
int GetMenuString(
   UINT nIDItem,
   CString& rString,
   UINT nFlags 
) const;

Параметры

  • nIDItem
    Указывает идентификатор пункта меню или целого числа смещения пункта меню в меню, в зависимости от значения nFlags.

  • lpString
    Указатель на буфер, который принимает метку.

  • rString
    Ссылка на объект CString, который принимает копированную строке меню.

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

  • nFlags
    Определяет интерпретация параметра nIDItem.Он может иметь одно из следующих значений:

    nFlags

    Интерпретация nIDItem

    MF_BYCOMMAND

    Указывает, что параметр содержит идентификатор команды существующего пункта меню.Это значение по умолчанию, если ни MF_BYCOMMAND ни MF_BYPOSITION установлены.

    MF_BYPOSITION

    Указывает, что данный параметр предоставляет позицию существующего пункта меню.Первый элемент в позиции 0.

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

Определяет фактическое число копируемых в буфер символов, не включая символ конца строки null.

Заметки

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

Пример

См. пример для CMenu::InsertMenu.

Требования

Header: afxwin.h

См. также

Ссылки

Класс CMenu

Диаграмма иерархии

CMenu::GetMenuState

CMenu::ModifyMenu

GetMenuString