BOOL AppendMenu( UINT nFlags, UINT nIDNewItem = 0, LPCTSTR lpszNewItem = NULL );
BOOL AppendMenu( UINT nFlags, UINT nIDNewItem, const CBitmap* pBmp );
Возвращаемое значение
Отлично от нуля, если функция успешна, иначе 0.
Параметры
nFlags
Определяет информацию относительно состояния нового пункта меню, когда это добавлено к меню. Это состоит из одного или большее количество значений, перечисленных в разделе Замечаний.
nIDNewItem
Определяет или команду ID нового пункта меню или, если nFlags установлен к MF_POPUP, дескриптор меню (HMENU) всплывающего меню. nIDNewItem параметр игнорируется (не необходим) если nFlags установлен к MF_SEPARATOR.
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_CHECKED - Действует как переключатель с MF_UNCHECKED, чтобы поместить заданную по умолчанию галочку рядом с элементом. Когда прикладная программа обеспечивает точечные рисунки галочки (см. SetMenuItemBitmaps функцию), " галочка на " точечный рисунок отображается.
- MF_UNCHECKED - Действует как переключатель с MF_CHECKED, чтобы удалить галочку рядом с элементом. Когда прикладная программа обеспечивает точечные рисунки галочки (см. SetMenuItemBitmaps функцию), "галочка от" точечный рисунок отображается.
- MF_DISABLED - Отключает пункт меню так, чтобы оно не могло быть выбрано, но не делает его тусклым.
- MF_ENABLED - Допускает пункту меню так, чтобы оео могло быть выбрано и восстановит это из недоступного состояния.
- MF_GRAYED - Отключает пункт меню так, чтобы оно не могло быть выбрано и делает его тусклым.
- MF_MENUBARBREAK - Помещает элемент в новую строку в статических меню или в новом столбце в всплывающим меню. Новый столбец всплывающего меню будет отделяться от старого столбца вертикальной разделительной линией.
- MF_MENUBREAK - Помещает элемент в новую строку в статических меню или в новом столбце в всплывающем меню. Никакая разделительная линия не помещена между столбцами.
- MF_OWNERDRAW - Определяет, что элемент - владелец - выводящийся элемент. Когда меню отображается впервые, окно, которое обладает меню, получает WM_MEASUREITEM сообщение, которое восстанавливает высоту и ширину пункта меню. WM_DRAWITEM сообщение - то посланное всякий раз, когда владелец должен модифицировать визуальное появление пункта меню. Эта опция не допустима для верхнего уровня пункта меню.
- MF_POPUP - Определяет, что пункт меню имеет всплывающее меню, связанное с этим. Параметр ID определяет дескриптор к всплывающему меню, которое должно быть связано с элементом. Это используется для добавления или верхнего уровня всплывающее меню с или иерархическое всплывающее меню для пункта меню.
- MF_SEPARATOR - Выводит горизонтальную разделительную линию. Может только использоваться в всплывающем меню. Эта строка не может быть недоступна, заблокирован, или высвечен. Другие параметры игнорируются.
- MF_STRING - Определяет, что пункт меню - символьная строка.
Каждая из следующих групп вносит в список флажки, которые являются взаимно исключительными и не могут использоваться вместе:
MF_DISABLED, MF_ENABLED, и MF_GRAYED
MF_STRING, MF_OWNERDRAW, MF_SEPARATOR, и растровая версия
MF_MENUBARBREAK и MF_MENUBREAK
MF_CHECKED и MF_UNCHECKED
Всякий раз, когда меню, которое постоянно находится в окне, изменено (отображается или нет окно), прикладная программа должна вызвать CWnd::DrawMenuBar.