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