Compartilhar via


Função ImmAssociateContextEx (imm.h)

Altera a associação entre o contexto do método de entrada e a janela especificada ou seus filhos.

Sintaxe

BOOL ImmAssociateContextEx(
  [in] HWND  unnamedParam1,
  [in] HIMC  unnamedParam2,
  [in] DWORD unnamedParam3
);

Parâmetros

[in] unnamedParam1

Manipule para a janela a ser associada ao contexto de entrada.

[in] unnamedParam2

Manipule para o contexto do método de entrada.

[in] unnamedParam3

Sinalizadores que especificam o tipo de associação entre a janela e o contexto do método de entrada. Esse parâmetro pode ter um dos valores a seguir.

Valor Significado
IACE_CHILDREN
Associe o contexto do método de entrada apenas às janelas filho da janela especificada.
IACE_DEFAULT
Restaure o contexto do método de entrada padrão da janela.
IACE_IGNORENOCONTEXT
Não associe o contexto do método de entrada a janelas que não estão associadas a nenhum contexto de método de entrada.

Valor retornado

Retornará TRUE se tiver êxito ou FALSE caso contrário.

Comentários

Se o aplicativo chamar essa função com IACE_CHILDREN, o sistema operacional associará o contexto do método de entrada especificado a janelas filho da janela indicada pelo hWnd. Ele associa o contexto do método de entrada somente a janelas filho do thread que cria hWnd. Qualquer janela filho criada depois que essa função tiver sido chamada não será afetada. Em vez disso, o contexto do método de entrada padrão será associado a ele.

Se o aplicativo chamar essa função com IACE_DEFAULT, o sistema operacional restaurará o contexto de método de entrada padrão para a janela. Nesse caso, o parâmetro hIMC é ignorado.

Requisitos

   
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 imm.h (inclua Immdev.h, Windows.h)
Biblioteca Imm32.lib
DLL Imm32.dll

Confira também

Gerenciador de Métodos de Entrada

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