CMenu::AppendMenu

BOOLAppendMenu (nFlags,UINTUINTnIDNewItem = 0,LPCTSTRlpszNewItem = NULL);

BOOL AppendMenu ( UINT nFlags, UINT nIDNewItem, const CBitmap * pBmp );

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

Ненулевое значение, если функция выполнена успешно; в противном случае 0.

Параметры

nFlags

Указывает сведения о состоянии нового пункта меню при добавлении в меню. Он состоит из одного или нескольких значений, перечисленных в разделе "Примечания".

nIDNewItem

Указывает Идентификатор команды нового пункта меню или, если nFlags имеет значение MF_POPUP, меню ручки (HMENU) из всплывающего меню. Параметр nIDNewItem не используется (не требуется), если nFlags имеет значение MF_SEPARATOR.

lpszNewItem

Указывает содержимое нового пункта меню. Параметр nFlags используется для интерпретации lpszNewItem следующим образом:

nFlags	Интерпретация lpszNewItem
MF_OWNERDRAW	Содержит приложение 32-разрядное значение, приложение можно использовать для поддержки дополнительные данные, связанные с пунктом меню. Это 32-разрядное значение доступной для приложения при обработке сообщений WM_MEASUREITEM и WM_DRAWITEM . Значение хранится в ItemData отсутствует член структуры, поставляемых с этими сообщениями.
MF_STRING	Содержит указатель на строку, оканчивающуюся нулем. Это по умолчанию интерпретация.
MF_SEPARATOR	LpszNewItem параметр игнорируется (не требуется).

pBmp

Указывает на объект CBitmap , который будет использоваться в качестве элемента меню.

Примечания

Добавляет новый элемент в конец меню. Приложение, можно указать состояние элемента меню, установив значения в nFlags. Когда nIDNewItem указывает всплывающее меню, он становится частью меню, к которой она прилагается. Если уничтожается что меню, пункты меню, добавленные также разрушается. Пункты меню, добавленные следует отделить от объекта CMenu , чтобы избежать конфликтов. Обратите внимание, что MF_STRING и MF_OWNERDRAW не являются действительными для растровых версии AppendMenu.

В следующем списке описываются флаги, которые могут быть установлены в nFlags:

MF_CHECKEDnbsp; Действует как переключатель с MF_U&NCHECKED поставить по умолчанию флажок рядом с элементом. Когда приложение передает галочки растровые изображения (см. функцию-член SetMenuItemBitmaps ), "флажок" точечный рисунок отображается.
MF_U&NCHECKEDnbsp; Действует как переключатель с MF_CHECKED , чтобы удалить флажок рядом с элементом. Когда приложение передает галочки растровые изображения (см. функцию-член SetMenuItemBitmaps ), "флажок Выкл" точечный рисунок отображается.
MF_DISABLED Отключает элемент меню таким образом, чтобы он не может быть выбран, но не уменьшайте.
MF_E&NABLEDnbsp; Позволяет активировать пункт меню может быть выбран и восстанавливает его от его серым государства.
MF_GRAYED Отключает элемент меню таким образом, чтобы он не может быть выбран и ее неактивной.
MF_ME&NUBARBREAKnbsp; Помещает элемент на новой строке в статическое меню или столбца во всплывающих меню. Новый столбец всплывающее меню будет отделяться от старого столбца вертикальной разделительной линии.
MF_ME&NUBREAKnbsp; Помещает элемент на новой строке в статическое меню или столбца во всплывающих меню. Размещены без разделительной линии между столбцами.
MF_OW&NERDRAWnbsp; Указывает, что элемент является владельцем элемент. Когда в первый раз появится меню, окно, которому принадлежит меню получает WM_MEASUREITEM сообщение, которое получает высоту и ширину элемента меню. WM_DRAWITEM сообщение является направил всякий раз, когда владелец должен обновить внешний вид элемента меню. Этот параметр является недопустимым для пункта меню верхнего уровня.
MF_POPUP Указывает, что элемент меню имеет всплывающее меню, связанное с ним. Параметр ID определяет дескриптор всплывающее меню, которое должно быть связано с пунктом. Этот метод используется для добавления всплывающее меню верхнего уровня или иерархической всплывающее меню в элемент всплывающего меню.
MF_SEPARATOR Рисует горизонтальную разделительную линию. Может использоваться только во всплывающем меню. Эта линия нельзя серым цветом, отключить или выделены. Другие параметры игнорируются.
MF_STRI&NGnbsp; Указывает, что пункт меню является строка символов.

Каждый из следующих групп перечислены флаги, которые являются взаимоисключающими и не могут использоваться совместно:

MF_DISABLED, MF_ENABLEDи MF_GRAYED
MF_STRING, MF_OWNERDRAW, MF_SEPARATORи версии растровых
MF_MENUBARBREAK и MF_MENUBREAK
MF_CHECKED и MF_UNCHECKED

Изменении меню, которое находится в окне (или не отображаться окно), в приложении следует вызвать CWnd::DrawMenuBar.

Обзор CMenu |nbsp; Члены класса | Иерархическая схема

См. такжеnbsp;CWnd::DrawMenuBar, CMenu::InsertMenu, CMenu::RemoveMenu, CMenu::SetMenuItemBitmaps, CMenu::Detach, :: AppendMenu

Index