Função ImmAssociateContextEx (immdev.h)

  • Artigo

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 de método de entrada especificado a janelas filho da janela indicada por 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 immdev.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