Estrutura IMEMENUITEMINFOA (imm.h)

Artigo
11/20/2024

Contém informações sobre itens de menu IME.

Sintaxe

typedef struct tagIMEMENUITEMINFOA {
  UINT    cbSize;
  UINT    fType;
  UINT    fState;
  UINT    wID;
  HBITMAP hbmpChecked;
  HBITMAP hbmpUnchecked;
  DWORD   dwItemData;
  CHAR    szString[IMEMENUITEM_STRING_SIZE];
  HBITMAP hbmpItem;
} IMEMENUITEMINFOA, *PIMEMENUITEMINFOA, *NPIMEMENUITEMINFOA, *LPIMEMENUITEMINFOA;

Membros

cbSize

Tamanho, em bytes, da estrutura.

fType

Tipo de item de menu. Esse membro pode ter um dos seguintes valores.

Valor	Significado
IMFT_RADIOCCHECK	Exiba itens de menu marcados usando uma marca de botão de opção em vez de uma marca de seleção se o membro hbmpChecked estiver NULL.
IMFT_SEPARATOR	O item de menu é um separador. Um separador de item de menu aparece como uma linha divisória horizontal. Os membros hbmpItem e szString são ignorados nesse caso.
IMFT_SUBMENU	O item de menu é um submenu.

fState

Estado do item de menu. Esse membro pode ter um ou mais dos seguintes valores:

Valor	Significado
IMFS_CHECKED	O item de menu está marcado. Para obter mais informações, consulte a descrição do membro hbmpChecked.
IMFS_DEFAULT	O item de menu é o padrão. Um menu pode conter apenas um item de menu padrão, que é exibido em negrito.
IMFS_DISABLED	O item de menu está desabilitado e aparece esmaecido para que não possa ser selecionado. Isso é equivalente a IMFS_GRAYED.
IMFS_ENABLED	O item de menu está habilitado. Esse é o estado padrão.
IMFS_GRAYED	O item de menu está desabilitado e aparece esmaecido para que não possa ser selecionado. Isso é equivalente a IMFS_DISABLED.
IMFS_HILITE	O item de menu está realçado.
IMFS_UNCHECKED	O item de menu está desmarcado. Para obter mais informações sobre itens de menu desmarcados, consulte a descrição do membro hbmpUnchecked.
IMFS_UNHILITE	O item de menu não está realçado. Esse é o estado padrão.

wID

Valor de 16 bits definido pelo aplicativo que identifica o item de menu.

hbmpChecked

Manipule para o bitmap a ser exibido ao lado do item se ele estiver marcado. Se esse membro estiver NULL, um bitmap padrão será usado. Se o valor do tipo IMFT_RADIOCHECK for especificado, o bitmap padrão será um marcador. Caso contrário, será uma marca de seleção.

hbmpUnchecked

Manipule para o bitmap a ser exibido ao lado do item se ele não estiver marcado. Se esse membro estiver NULL, nenhum bitmap será usado.

dwItemData

Valor definido pelo aplicativo associado ao item de menu.

szString[IMEMENUITEM_STRING_SIZE]

Conteúdo do item de menu. Essa é uma cadeia de caracteres terminada em nulo.

hbmpItem

Manipule para um bitmap a ser exibido.

Observações

Nota

O cabeçalho imm.h define IMEMENUITEMINFO como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
cabeçalho	imm.h (inclua Immdev.h, Windows.h)

Consulte também

ImmGetImeMenuItems

do Gerenciador de Métodos de Entrada

estruturas do Gerenciador de Métodos de Entrada

Compartilhar via