AppendMenu

AppendMenu функція додавання нового елемента кінець вказане меню бару, розкривного меню, підменю або контекстне меню. Ця функція використовується для визначення вмісту, зовнішній вигляд і поведінку пункту меню.

AppendMenu функція була замінена InsertMenuItem функції. Ви можете використовувати AppendMenu, однак, якщо вам не потрібна, розширені функції InsertMenuItem.

 (BOOL AppendMenu HMENU  hMenu, / / ручка, меню, щоб змінитиUINTuFlags, / / елемент меню прапориUINTuIDNewItem, / / ідентифікатор пункт меню або маркер, щоб розкривного меню або підменю.LPCTSTRlpNewItem / / елемент меню вмісту);

Параметри

hMenu

Обробляти рядок меню, меню, підменю або контекстне меню, щоб змінити.

uFlags

Визначає позначки контролювати вигляд і поведінку нових пункту меню. Цей параметр може бути поєднання значення, наведені в цьому розділі зауваження.

uIDNewItem

Визначає ідентифікатор новий пункт меню або, якщо параметр uFlags MF_POPUP ручку, щоб розкривного меню або підменю.

lpNewItem

Визначає вміст новий пункт меню. Тлумачення lpNewItem залежить від того, чи uFlags параметр включає MF_BITMAP, MF_OWNERDRAW або MF_STRING прапор, таким чином:

Значення	Опис
MF_BITMAP	Містить ручку крапковий малюнок.
MF_OWNERDRAW	Містить значення 32-розрядні поставляється додатків, які можуть бути використані для підтримки додаткові дані, пов'язані з пункту меню. Має значення в itemData член структури вказаний параметр lparam на WM_MEASURE або WM_DRAWITEM повідомлення, яке надсилається, коли створюється у меню або оновлення його зовнішній вигляд.
MF_STRING	Містить вказівник на рядок із нульовим.

Повернення значень

Якщо функція завершено успішно, значення, що повертається, є ненульовим.

Якщо функцію не вдається, значення дорівнює нулю. Щоб отримати докладні відомості про помилку, зателефонуйте GetLastError.

Зауваження

Застосування повинні викликати функцію DrawMenuBar кожного разу, коли меню зміни, або ні, мене це відображається вікно.

Отримати корисні можливості клавіатури для роботи з крапковий малюнок або пункти меню власник звертається, власник меню потрібно обробити повідомлення WM_MENUCHAR. Докладніше перегляньте Owner-Drawn меню та WM_MENUCHAR повідомлення.

Наступні позначки можна встановити параметр uFlags:

Значення	Опис
MF_BITMAP	Використовує крапковий малюнок як елемент меню. LpNewItem параметр містить маркер, щоб малюнка.
MF_CHECKED	Встановлює прапорець поруч із елементом меню. Якщо додаток забезпечує позначка крапкові малюнки (див. SetMenuItemBitmaps, цей прапор показує, бітові прапорець поруч із елементом меню.
MF_DISABLED	Вимикає елемент меню, тому його не можна вибрати, але прапор не сірий, це.
MF_ENABLED	Дозволяє елемент меню, так що можна вибрати і відновлює його від його затінена державою.
MF_GRAYED	Вимикає меню і grays, тому його не можна вибрати.
MF_MENUBARBREAK	Функції ж, як на MF_MENUBREAK позначення для рядка меню. Розкривне меню, підменю або контекстне меню новий стовпець відокремлюються від старого стовпця вертикальна лінія.
MF_MENUBREAK	Розташовує елемент на новий рядок (для рядка меню) або в новому стовпці (для розкривного меню, підменю або контекстне меню) без поділу стовпців.
MF_OWNERDRAW	Визначає, що елемент — це елемент, власник звертається. Перш ніж в перший раз відображення меню, вікна, що володіє меню отримує повідомлення WM_MEASUREITEM отримати ширину та висоту пункту меню. WM_DRAWITEM повідомлення потім відправляється до процедури вікна вікна власник кожного разу, коли необхідно оновити зовнішній вигляд пункт меню.
MF_POPUP	Вказує, що пункт меню відкриває спадне меню або підменю. Параметр uIDNewItem визначає маркер, щоб розкривного меню або підменю. Цей прапор використовується, щоб додати ім'я меню в рядку меню або елемент меню, який відкриває вкладене меню для розкривного меню, підменю або контекстне меню.
MF_SEPARATOR	Малювання горизонтальних розділової лінією. Цей прапор використовується тільки в розкривному меню, підменю або контекстне меню. Сірим кольором, вимкнуто або виділені лінії неможливо. 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

Windows CE: Наступні варіанти стану не підтримуються для параметра fuFlags

MF_BITMAP

MF_DISABLED

MFS_GRAYED

MF_GRAYED можуть бути використані в якості MF_DISABLED і MFS_GRAYED.

Windows CE 1.0 не підтримує каскадних меню. Якщо ви використовуєте Windows CE 1.0, не вдається вставити MF_POPUP-меню до іншого спливаючого меню.

У Windows CE 1.0 не підтримуються наступні варіанти стану:

MF_POPUP

MF_MENUBREAK

MF_MENUBARBREAK

У версіях Windows CE 2.0 і пізніше ці прапори підтримуються. Також підтримуються каскадних меню.

Дивіться також

Огляд меню, меню функцій, CreateMenu, DeleteMenu, DestroyMenu, DrawMenuBar, InsertMenu, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps

Index