Função ImmGetImeMenuItemsA (imm.h)

Artigo
11/20/2024

Recupera os itens de menu registrados no menu IME de um contexto de entrada especificado.

Sintaxe

DWORD ImmGetImeMenuItemsA(
  [in]            HIMC               unnamedParam1,
  [in]            DWORD              unnamedParam2,
  [in]            DWORD              unnamedParam3,
  [out, optional] LPIMEMENUITEMINFOA lpImeParentMenu,
  [out, optional] LPIMEMENUITEMINFOA lpImeMenu,
  [in]            DWORD              dwSize
);

Parâmetros

[in] unnamedParam1

Manipule para o contexto de entrada para os itens de menu especificados.

[in] unnamedParam2

Sinalizar as opções de informações do menu de especificação. O valor a seguir é definido.

Valor	Significado
IGIMIF_RIGHTMENU	Recupere os itens de menu do menu de contexto, obtidos por um clique com o botão direito do mouse.

[in] unnamedParam3

Tipo de menu a ser recuperado. Esse parâmetro pode ter um ou mais dos valores a seguir.

Valor	Significado
IGIMII_CMODE	Recupere os itens de menu que controlam o modo de conversão.
IGIMII_SMODE	Recupere os itens de menu que controlam o modo de frase.
IGIMII_CONFIGURE	Recupere os itens de menu relacionados à configuração do IME.
IGIMII_TOOLS	Recupere os itens de menu relacionados às ferramentas IME.
IGIMII_HELP	Recupere os itens de menu que controlam a Ajuda do IME.
IGIMII_OTHER	Recupere os itens de menu que controlam outras funções IME.
IGIMII_INPUTTOOLS	Recupere os itens de menu que controlam itens de menu relacionados às ferramentas de entrada do IME, fornecendo uma maneira estendida de inserir caracteres.

[out, optional] lpImeParentMenu

Ponteiro para uma estrutura IMEMENUITEMINFO na qual a função recupera informações do menu pai. Para recuperar informações sobre os itens de submenu desse menu pai, o aplicativo define o membro fType como MFT_SUBMENU. Esse parâmetro contém NULL se a função recuperar apenas itens de menu de nível superior.

[out, optional] lpImeMenu

Ponteiro para uma matriz de estruturas de IMEMENUITEMINFO em que a função recupera informações sobre os itens de menu. Esse parâmetro contém NULL se a função recuperar o número de itens de menu registrados.

[in] dwSize

Tamanho do buffer para receber a estrutura de IMEMENUITEMINFO .

Valor de retorno

Retorna o número de itens de menu copiados para lpImeMenu. Se lpImeMenu especificar NULL, a função retornará o número de itens de menu registrados no contexto de entrada especificado.

Observações

Nota

O cabeçalho imm.h define ImmGetImeMenuItems como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do 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 XP [somente aplicativos da área de trabalho], suporte à linguagem do Leste Asiático instalado.
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	imm.h (inclua Immdev.h, Windows.h)
biblioteca	Imm32.lib
de DLL	Imm32.dll

Consulte também

IMEMENUITEMINFO

do Gerenciador de Métodos de Entrada

Funções do Gerenciador de Métodos de Entrada

Compartilhar via