InsertMenu

InsertMenu функція вставляє новий елемент меню в меню, рухався інших елементів меню.

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

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

Параметри

hMenu

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

uPosition

Вказує елемент меню, перед яким новий пункт меню є вставлені, як визначається параметром uFlags.

uFlags

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

Значення	Опис
MF_BYCOMMAND	Вказує на те, що uPosition параметр дає ідентифікатор пункту меню. MF_BYCOMMAND прапор використовується за замовчуванням, якщо вказано ні MF_BYCOMMAND, ні MF_BYPOSITION прапор.
MF_BYPOSITION	Вказує на те, що uPosition параметр дає COLUMN відносне розташування новий пункт меню. Якщо uPosition 0xFFFFFFFF, новий пункт меню додається в кінці меню.

uIDNewItem

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

lpNewItem

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

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

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

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

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

Зауваження

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

У наступному списку описуються прапори, які можна встановити в параметрі 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_BYCOMMAND і MF_BYPOSITION
MF_DISABLED, MF_ENABLED і MF_GRAYED
MF_BITMAP, MF_STRING, MF_OWNERDRAW і MF_SEPARATOR
MF_MENUBARBREAK і MF_MENUBREAK
MF_CHECKED і MF_UNCHECKED

Windows CE: Windows CE не підтримує прапор MF_BITMAP або MF_DISABLED позначку в параметрі uFlags . Елементи меню не може бути вимкнутий без бути сірим кольором. Щоб вимкнути елемент меню використовувати прапор MF_GRAYED.

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

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

Огляд меню, меню функцій, AppendMenu, DeleteMenu, DrawMenuBar, InsertMenuItem, ModifyMenu, RemoveMenu, SetMenuItemBitmaps, WM_DRAWITEM, WM_MEASUREITEM

Index