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


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