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