MENUITEMINFO

MENUITEMINFO структура містить інформацію про елемент меню.

typedef типу struct {tagMENUITEMINFO
    UINT cbSize; 
    UINT fMask; 
    UINT fType; 
    UINT fState; 
    UINT wID; 
    HMENU hSubMenu; 
    HBITMAP hbmpChecked; 
    HBITMAP hbmpUnchecked; 
    DWORD dwItemData; 
    LPTSTR dwTypeData; 
    UINT cch; 
} MENUITEMINFO, НАБАГАТО * LPMENUITEMINFO 

 

Члени

cbSize

Розмір структури, у байтах.

fMask

Членів, щоб отримати або встановити. Цей компонент може бути один або більше з цих значень:

Значення	Значення
MIIM_CHECKMARKS	Повертає або встановлює членів hbmpChecked і hbmpUnchecked.
MIIM_DATA	Повертає або встановлює член dwItemData.
MIIM_ID	Повертає або встановлює член wID.
MIIM_STATE	Повертає або встановлює член fState.
MIIM_SUBMENU	Повертає або встановлює член hSubMenu.
MIIM_TYPE	Повертає або встановлює членів fType і dwTypeData.

fType

Пункт меню типу. Цей компонент може бути один або більше з цих значень:

Значення	Значення
MFT_BITMAP	Відображає елемент меню, за допомогою крапковий малюнок. Низька замовлення слово dwTypeData член є бітових ручку, і член cch ігнорується.
MFT_MENUBARBREAK	Розміщує елемент меню в новому рядку (для рядка меню) або в новому стовпці (для розкривного меню, підменю або контекстне меню). Розкривне меню, підменю або контекстне меню вертикальні лінії відокремлює нового стовпця від старого.
MFT_MENUBREAK	Розміщує елемент меню в новому рядку (для рядка меню) або в новому стовпці (для розкривного меню, підменю або контекстне меню). Розкривне меню, підменю або контекстне меню стовпці не розділені вертикальні лінії.
MFT_OWNERDRAW	Призначає відповідальність для малювання пункт меню вікно, що володіє меню. Вікно отримує WM_MEASUREITEM повідомлення, перш ніж відображення меню в перший раз і WM_DRAWITEM повідомлення кожного разу, коли необхідно оновити зовнішній вигляд меню. Якщо цей параметр указано, член dwTypeData містить значення 32-розрядних застосунків визначено.
MFT_RADIOCHECK	Відображає перевірили пункти меню, за допомогою радіо кнопки Марк замість того, щоб позначка, якщо член hbmpChecked є NULL.
MFT_RIGHTJUSTIFY	Праворуч вирівнювання пункту меню і всі наступні елементи. Цей параметр діє, лише якщо елемент меню в рядку меню.
MFT_RIGHTORDER	Windows 95, Windows NT 5.0 і більш пізніх:Визначає, що меню Каскад справа наліво (за промовчанням це зліва направо). Це використовується для підтримки для письма справа наліво, таких мов, як арабська та Іврит. `
MFT_SEPARATOR	Вказує, що пункт меню є роздільник. Роздільник елементів меню з'являється у вигляді горизонтальної лінії поділу. Члени dwTypeData і cch ігноруються. Це значення є дійсним тільки в розкривному меню, підменю або контекстне меню.
MFT_STRING	Відображає елемент меню, за допомогою текстового рядка. Член dwTypeData курсор в рядок з нульовим, і член cch довжина рядка.

MFT_BITMAP, MFT_SEPARATOR і MFT_STRING значення не може поєднуватися з один одного.

fState

Меню елемент стан. Цей компонент може бути один або більше з цих значень:

Значення	Значення
MFS_CHECKED	Перевіряє пункту меню. Щоб отримати додаткові відомості про елементи, позначені меню перегляньте hbmpChecked член.
MFS_DEFAULT	Призначення елемента меню за замовчуванням. Меню можуть містити лише один елемент меню за промовчанням, який відображено жирним шрифтом.
MFS_DISABLED	Вимикає меню, так що його неможливо виділити, але не сірий, це.
MFS_ENABLED	Дозволяє елемент меню, так що вона може бути обрана. Це стандартний стан.
MFS_GRAYED	Вимикає пункту меню і grays його, так що це не можна вибрати.
MFS_HILITE	Виділяє пункт меню.
MFS_UNCHECKED	Unchecks пункт меню. Щоб отримати додаткові відомості про елементи меню не зупинити перегляньте hbmpUnchecked член.
MFS_UNHILITE	Видаляє виділення з пункту меню. Це стандартний стан.

wID

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

hSubMenu

Працювати з розкривного меню або підменю, пов'язаних з пункту меню. Якщо елемент меню не елемента, який відкриває спадне меню або підменю, цей компонент є NULL.

hbmpChecked

Ручкою на растрове зображення для відображення поруч з елементом, якщо його установлено. Якщо цей компонент NULL, використовується за промовчанням крапковий малюнок. Якщо вказано значення типу MFT_RADIOCHECK, точковий рисунок за промовчанням — маркер. В іншому випадку, це позначка.

hbmpUnchecked

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

dwItemData

Визначений у застосунку значення, пов'язані з пункту меню.

dwTypeData

Зміст пункту меню. Цей компонент використовується, лише якщо прапор MIIM_TYPE має значення в fMask член.

Перед викликом GetMenuItemInfo, застосування необхідно встановити цей компонент команду буфер, довжину якого визначається cch члена. Якщо отримані меню типу MFT_STRING, то GetMenuItemInfo копій текст елемента меню в буфер. Якщо отримані меню елемент деякі інші типу, потім GetMenuItemInfo встановлює член dwTypeData до значення, тип якого є членом fType.

Під час використання функції SetMenuItemInfo , цей компонент повинен містить значення, тип якого є членом fType.

cch

Довжина тексту елемент меню, отримання інформації про пункт меню типу MFT_STRING. Цей компонент використовується, лише якщо MIIM_TYPE прапор встановлюється в fMask член і в іншому випадку дорівнює нулю. Цей компонент ігнорується, коли вміст елемента меню за номером SetMenuItemInfo.

Перед викликом GetMenuItemInfo, додаток повинні встановити цей компонент довжина буфера, вказав на dwTypeData членом. Якщо отримані меню типу MFT_STRING (як вказано fType членом), потім GetMenuItemInfo встановлює cch довжина Процитовано рядка. Якщо отримані меню елемент деякі інші типу, GetMenuItemInfo встановлює cch поля до нуля.

Зауваження

MENUITEMINFO структура використовується з GetMenuItemInfo, InsertMenuItemі SetMenuItemInfo функції.

QuickInfo

nbsp; Windows &NT: вимагає 4.0 або пізнішої версії.
Windows:Вимагає Windows 95 або пізнішої версії.
Windows CE:Потрібна Версія 1.0 або пізнішу версію.
Заголовка:Оголошена в winuser.h.
Юнікод:Визначено як Unicode та ANSI структури.

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

Меню огляд, структури меню, GetMenuItemInfo, InsertMenuItem, SetMenuItemInfo, WM_DRAWITEM, WM_MEASUREITEM