MENUITEMINFO

O MENUITEMINFO estrutura contém informações sobre um item de menu.

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, ATÉ AGORA * LPMENUITEMINFO 

 

Membros

cbSize

Tamanho da estrutura, em bytes.

fMask

Membros para recuperar ou definir. Esse membro pode ser um ou mais desses valores:

Valor	Significado
MIIM_CHECKMARKS	Recupera ou define o hbmpChecked e hbmpUnchecked Membros.
MIIM_DATA	Recupera ou define o membro dwItemData.
MIIM_ID	Recupera ou define o membro de wID.
MIIM_STATE	Recupera ou define o membro de fState.
MIIM_SUBMENU	Recupera ou define o membro de hSubMenu.
MIIM_TYPE	Recupera ou define o fType e dwTypeData Membros.

fType

Tipo de item de menu. Esse membro pode ser um ou mais desses valores:

Valor	Significado
MFT_BITMAP	Exibe o item de menu usando um bitmap. A baixa palavra de ordem o membro dwTypeData é o identificador de bitmap, e o membro de cch é ignorado.
MFT_MENUBARBREAK	Coloca o item de menu em uma nova linha (para uma barra de menus) ou em uma nova coluna (para um drop-down menu, submenu ou menu de atalho). Para um drop-down menu, submenu ou menu de atalho, uma linha vertical separa a nova coluna do antigo.
MFT_MENUBREAK	Coloca o item de menu em uma nova linha (para uma barra de menus) ou em uma nova coluna (para um drop-down menu, submenu ou menu de atalho). Para um drop-down menu, submenu ou menu de atalho, as colunas não são separadas por uma linha vertical.
MFT_OWNERDRAW	Atribui responsabilidade para desenhar o item de menu para a janela que possui o menu. A janela recebe uma mensagem WM_MEASUREITEM antes que o menu é exibido pela primeira vez e uma mensagem WM_DRAWITEM sempre que a aparência do item de menu deve ser atualizada. Se esse valor for especificado, o membro dwTypeData contém um valor de 32 bits aplicativo-definidos.
MFT_RADIOCHECK	Exibe check marcam de itens de menu usando um botão de rádio em vez de uma marca de verificação se o hbmpChecked membro é NULL.
MFT_RIGHTJUSTIFY	Direito-justifica o item de menu e os itens subseqüentes. Esse valor é válido somente se o item de menu estiver em uma barra de menus.
MFT_RIGHTORDER	Windows 95, Windows NT 5.0 e posterior:Especifica que os menus em cascata direita para a esquerda (o padrão é esquerda para a direita). Isso é usado para oferecer suporte a idiomas da direita para a esquerda, como árabe e hebraico. `
MFT_SEPARATOR	Especifica que o item de menu é um separador. Um separador de item de menu é exibido como uma linha divisória horizontal. Os membros dwTypeData e cch são ignorados. Esse valor é válido somente em um drop-down menu, submenu ou menu de atalho.
MFT_STRING	Exibe o item de menu usando uma Cadeia de caracteres de texto. O membro dwTypeData é o ponteiro para uma Cadeia de caracteres terminada por caractere nulo, e o membro de cch é o comprimento da seqüência de caracteres.

Os valores MFT_BITMAP, MFT_SEPARATOR e MFT_STRING não podem ser combinados uns com os outros.

fState

Estado do item de menu. Esse membro pode ser um ou mais desses valores:

Valor	Significado
MFS_CHECKED	Verifica o item de menu. Para obter mais informações sobre itens de menu selecionado, consulte o hbmpChecked membro.
MFS_DEFAULT	Especifica que o item de menu é o padrão. Um menu pode conter somente um item de menu padrão, é exibido em negrito.
MFS_DISABLED	Desabilita o item de menu para que ele não pode ser selecionado, mas não cinza-lo.
MFS_ENABLED	Permite que o item de menu para que ele pode ser selecionado. Este é o estado padrão.
MFS_GRAYED	Desabilita o item de menu e grays-lo para que ele não pode ser selecionado.
MFS_HILITE	Destaca o item de menu.
MFS_UNCHECKED	Desmarca o item de menu. Para obter mais informações sobre itens desmarcados menu, consulte o membro hbmpUnchecked.
MFS_UNHILITE	Remove o realce o item de menu. Este é o estado padrão.

wID

Valor de 16-bit Application-defined que identifica o item de menu.

hSubMenu

Identificador para o drop-down menu ou submenu associado com o item de menu. Se o item de menu não é um item que abre um Soltar-para baixo menu ou um submenu, esse membro é NULL.

hbmpChecked

Identificador para o bitmap para exibir próximo para o item se ele estiver marcado. Se esse membro é NULL, um bitmap padrão será usado. Se o valor do tipo MFT_RADIOCHECK for especificado, o bitmap padrão tem uma bala. Caso contrário, é uma marca de seleção.

hbmpUnchecked

Identificador para o bitmap para exibir próximo para o item se ele não estiver marcado. Se esse membro é NULL, nenhum bitmap é usado.

dwItemData

Valor Application-defined associado com o item de menu.

dwTypeData

Conteúdo do item de menu. Esse membro é usado somente se o sinalizador MIIM_TYPE é definido in a fMask membro.

Antes de chamar GetMenuItemInfo, o aplicativo deve definir esse membro para apontar para uma reserva cujo comprimento é especificado pelo membro cch. Se o item de menu recuperado é do tipo MFT_STRING e, em seguida, GetMenuItemInfo copia o texto de item de menu para o buffer. Se o item de menu recuperado é de outro tipo, GetMenuItemInfo define o membro de dwTypeData a um valor cujo tipo é especificado pelo membro fType.

Ao usar com a função de SetMenuItemInfo , esse membro deve contém um valor cujo tipo é especificado pelo membro fType.

cch

Comprimento do texto do item de menu quando receber informações sobre um item de menu do tipo MFT_STRING. Esse membro é usado somente se o sinalizador MIIM_TYPE for definido in a fMask membro e é zero caso contrário. Esse membro é ignorado quando o conteúdo de um item de menu é definido pelo chamado SetMenuItemInfo.

Antes de chamar GetMenuItemInfo, o aplicativo deve definir esse membro para o comprimento do buffer apontado pelo membro dwTypeData . Se o item de menu recuperado é do tipo MFT_STRING (conforme indicado pelo membro fType ), GetMenuItemInfo define cch para o comprimento do seqüência de caracteres recuperado. Se o item de menu recuperado é de outro tipo, GetMenuItemInfo define o campo de cch para zero.

Observações

O MENUITEMINFO estrutura é usado com as funções GetMenuItemInfo, InsertMenuIteme SetMenuItemInfo.

QuickInfo

nbsp; Windows &NT: requer a versão 4.0 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Unicode:Definidos como estruturas ANSI e Unicode.

Ver também

Visão geral de menus, Menu estruturas, GetMenuItemInfo, InsertMenuItem, SetMenuItemInfo, WM_DRAWITEM, WM_MEASUREITEM