On-line справка по Win32 API

БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!

A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать

AppendMenu

The AppendMenu function appends a new item to the end of the specified menu bar, drop-down menu, submenu, or shortcut menu. You can use this function to specify the content, appearance, and behavior of the menu item.

The AppendMenu function has been superseded by the InsertMenuItem function. You can still use AppendMenu, however, if you do not need any of the extended features of InsertMenuItem.

BOOL AppendMenu(

HMENU hMenu, // handle to menu to be changed
UINT uFlags, // menu-item flags
UINT uIDNewItem, // menu-item identifier or handle of drop-down menu or submenu
LPCTSTR lpNewItem // menu-item content
);

Parameters

hMenu

Identifies the menu bar, drop-down menu, submenu, or shortcut menu to be changed.

uFlags

Specifies flags to control the appearance and behavior of the new menu item. This parameter can be a combination of the values listed in the following Remarks section.

uIDNewItem

Specifies either the identifier of the new menu item or, if the uFlags parameter is set to MF_POPUP, the handle to the drop-down menu or submenu.

lpNewItem

Specifies the content of the new menu item. The interpretation of lpNewItem depends on whether the uFlags parameter includes the MF_BITMAP, MF_OWNERDRAW, or MF_STRING flag, as follows:

Value Description
MF_BITMAP Contains a bitmap handle.
MF_OWNERDRAW Contains a 32-bit value supplied by the application that can be used to maintain additional data related to the menu item. The value is in the itemData member of the structure pointed to by the lparam parameter of the WM_MEASURE or WM_DRAWITEM message sent when the menu is created or its appearance is updated.
MF_STRING Contains a pointer to a null-terminated string.

Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The application must call the DrawMenuBar function whenever a menu changes, whether or not the menu is in a displayed window.
The following flags can be set in the uFlags parameter:

Value Description
MF_BITMAP Uses a bitmap as the menu item. The lpNewItem parameter contains the handle to the bitmap.
MF_CHECKED Places a check mark next to the menu item. If the application provides check-mark bitmaps (see SetMenuItemBitmaps), this flag displays the check mark bitmap next to the menu item.
MF_DISABLED Disables the menu item so it cannot be selected, but the flag does not gray it.
MF_ENABLED Enables the menu item so it can be selected, and restores it from its grayed state.
MF_GRAYED Disables the menu item and grays it so it cannot be selected.
MF_MENUBARBREAK Functions the same as the MF_MENUBREAK flag for a menu bar. For a drop-down menu, submenu, or shortcut menu, the new column is separated from the old column by a vertical line.
MF_MENUBREAK Places the item on a new line (for a menu bar) or in a new column (for a drop-down menu, submenu, or shortcut menu) without separating columns.
MF_OWNERDRAW Specifies that the item is an owner-drawn item. Before the menu is displayed for the first time, the window that owns the menu receives a WM_MEASUREITEM message to retrieve the width and height of the menu item. The WM_DRAWITEM message is then sent to the window procedure of the owner window whenever the appearance of the menu item must be updated.
MF_POPUP Specifies that the menu item opens a drop-down menu or submenu. The uIDNewItem parameter specifies the handle to the drop-down menu or submenu. This flag is used to add a menu name to a menu bar, or a menu item that opens a submenu to a drop-down menu, submenu, or shortcut menu.
MF_SEPARATOR Draws a horizontal dividing line. This flag is used only in a drop-down menu, submenu, or shortcut menu. The line cannot be grayed, disabled, or highlighted. The lpNewItem and uIDNewItem parameters are ignored.
MF_STRING Specifies that the menu item is a text string; the lpNewItem parameter points to the string.
MF_UNCHECKED Does not place a check mark next to the item (default). If the application supplies check-mark bitmaps (see SetMenuItemBitmaps), this flag displays the unchecked bitmap next to the menu item.

The following groups of flags cannot be used together:

· MF_DISABLED, MF_ENABLED, and MF_GRAYED
· MF_BITMAP, MF_STRING, and MF_OWNERDRAW
· MF_MENUBARBREAK and MF_MENUBREAK
· MF_CHECKED and MF_UNCHECKED

See Also

CreateMenu, DeleteMenu, DestroyMenu, DrawMenuBar, InsertMenu, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

AppendMenu

Функция AppendMenu добавляет новому пункту в конец определенной зоны меню, капли-вниз меню, субменю, или сокращенное меню. Вы можете использовать эту функцию, чтобы определять содержимое, появление, и поведение пункта меню.

Функция AppendMenu заменена функцией InsertMenuItem. Вы можете все еще использовать AppendMenu, тем не менее, если Вам не нужно любая из расширенных характеристик InsertMenuItem.

BOOL AppendMenu(

HMENU hMenu, // РУЧКА в меню, которое нужно изменять UINT uFlags, // меню-пункт флагов
UINT uIDNewItem, // МЕНЮ-пункт идентификатора или ручки капли-вниз меню или меню-пункт содержимого субменю LPCTSTR lpNewItem //
);

Параметры

hMenu

Идентифицирует зону меню, капли-вниз меню, субменю, или сокращенное меню, которые нужно изменяться.

uFlags

Определяет флаги, чтобы управлять появлением и поведением нового пункта меню. Этот параметр может быть комбинацией величин указанных в секции Замечаний следующего.

uIDNewItem

Определяет или идентификатор нового пункта меню или, если параметр uFlags установлен в MF_POPUP, ручку в каплю-вниз меню или субменю.

lpNewItem

Определяет содержимое нового пункта меню. Интерпретация lpNewItem зависит от включает параметр uFlags MF_BITMAP, MF_OWNERDRAW, или флаг MF_STRING, следующим образом:

Величина Description MF_BITMAP Содержит ручку побитового отображения.
MF_OWNERDRAW Содержит 32- битовую величину поставленную приложением, которое может быть использовано, чтобы поддерживать дополнительные данные имело отношение к пункту меню. Величина - в элементе itemData структуры указанной, чтобы параметром lparam WM_MEASURE или сообщение WM_DRAWITEM посылало когда меню создано или появление скорректировано.
MF_STRING Содержит указатель в недействительный расторгнутую строку.

Обратные Величины

Если функция добивается успеха, обратная величина ненулевая.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, вызовите GetLastError.

Замечания

Приложение должно вызвать функцию DrawMenuBar всякий раз, когда меню изменяет, во всяком случае меню - в отображаемом окне.
Следующее флагов может быть установлено в параметре uFlags:

Описание Величины
MF_BITMAP Использует побитовое отображение как пункт меню. Параметр lpNewItem содержит ручку в побитовое отображение.
MF_CHECKED Устанавливает контрольную отметку около пункта меню. Если приложение обеспечивает контрольная отметка побитовых отображений (смотри SetMenuItemBitmaps), этот флаг отображает контрольное побитовое отображение отметки около пункта меню.
MF_DISABLED Выводит из строя пункт меню, так что не может быть выбрано, но флаг не делает серым это.
MF_ENABLED Приспосабливается пункт меню, так что может быть выбрано, и восстановление это из своего grayed состояния.
MF_GRAYED Выводит из строя пункт меню и серый это, так что не может быть выбрано.
MF_MENUBARBREAK Функционирует такой же как и флаг MF_MENUBREAK для зоны меню. Для капли-вниз меню, субменю, или сокращенного меню, новый столбец выделен из старого столбца вертикальной строкой.
MF_MENUBREAK Устанавливает пункт в новой строке (для зоны меню) или в новом столбце (для капли-вниз меню, субменю, или сокращенного меню) не разделяя столбцы.
MF_OWNERDRAW Определяет, что пункт является сделанным пунктом владельца. Прежде, чем меню будет отобразиться впервые, окно, которое обладает приемникам меню сообщением WM_MEASUREITEM, чтобы извлекать ширину и высоту пункта меню. Сообщение WM_DRAWITEM - затем посланное в процедуру окна окна владельца всякий раз, когда появление пункта меню должно быть скорректировано.
MF_POPUP Определяет, что пункт меню открывает каплю-вниз меню или субменю. Параметр uIDNewItem определяет ручке в каплю-вниз меню или субменю. Этот флаг использован, чтобы добавлять имени меню к зоне меню, или пункту меню, которые открывают субменю в каплю-вниз меню, субменю, или сокращенное меню.
MF_SEPARATOR Делает горизонтальным делением строки. Этот флаг используется только в капле-вниз меню, субменю, или сокращенном меню. Линия Не может grayed, выведен из строя, или выделен. lpNewItem И параметры uIDNewItem проигнорированы.
MF_STRING Определяет, что пункт меню является текстовой строкой; параметр lpNewItem указывает на строку.
MF_UNCHECKED не устанавливает контрольную отметку около пункта (умолчание). Если приложение поставляет контрольная отметка побитовых отображений (смотри SetMenuItemBitmaps), этот флаг отображает неконтролируемое побитовое отображение около пункта меню.

Следующие группы флагов не могут использоваться вместе:

MF_DISABLED, MF_ENABLED, и MF_GRAYED MF_BITMAP, MF_STRING, и MF_OWNERDRAW MF_MENUBARBREAK и MF_MENUBREAK MF_CHECKED и MF_UNCHECKED

Смотри Также

CreateMenu, DeleteMenu, DestroyMenu, DrawMenuBar, InsertMenu, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps

Используются технологии uCoz