Função ImmGetImeMenuItemsW (immdev.h)

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

Sintaxe

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

Parâmetros

[in] unnamedParam1

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

[in] unnamedParam2

Sinalizador especificando opções de informações do menu. 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 do 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 conterá NULL se a função recuperar apenas itens de menu de nível superior.

[out, optional] lpImeMenu

Ponteiro para uma matriz de estruturas IMEMENUITEMINFO nas quais a função recupera informações sobre os itens de menu. Esse parâmetro conterá NULL se a função recuperar o número de itens de menu registrados.

[in] dwSize

Tamanho do buffer para receber a estrutura IMEMENUITEMINFO .

Retornar valor

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

Comentários

Observação

O cabeçalho immdev.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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho], suporte ao idioma do Leste Asiático instalado.
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho immdev.h (inclua Immdev.h, Windows.h)
Biblioteca Imm32.lib
DLL Imm32.dll

Confira também

IMEMENUITEMINFO

Gerenciador de Métodos de Entrada

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