Função ImmNotifyIME (immdev.h)

Artigo
08/24/2023

Notifica o IME sobre alterações no status do contexto de entrada.

Sintaxe

BOOL ImmNotifyIME(
       HIMC  unnamedParam1,
  [in] DWORD dwAction,
  [in] DWORD dwIndex,
  [in] DWORD dwValue
);

Parâmetros

unnamedParam1

[in] dwAction

Código de notificação. Esse parâmetro pode ter um dos valores a seguir.

Valor	Significado
NI_CHANGECANDIDATELIST	Um aplicativo alterou o candidato selecionado atualmente. O parâmetro dwIndex especifica um índice de uma lista de candidatos a ser selecionado e dwValue não é usado.
NI_CLOSECANDIDATE	Um aplicativo direciona o IME para fechar uma lista de candidatos. O parâmetro dwIndex especifica um índice da lista a ser fechada e dwValue não é usado. O IME envia um comando IMN_CLOSECANDIDATE para o aplicativo se ele fechar a lista.
NI_COMPOSITIONSTR	Um aplicativo direciona o IME para executar uma ação na cadeia de caracteres de composição. O parâmetro dwIndex pode ser CPS_CANCEL, CPS_COMPLETE, CPS_CONVERT ou CPS_REVERT.
NI_IMEMENUSELECTED	Um aplicativo direciona o IME para permitir que o aplicativo manipule o menu especificado. O parâmetro dwIndex especifica a ID do menu e dwValue é um valor definido pelo aplicativo para esse item de menu.
NI_OPENCANDIDATE	Um aplicativo direciona o IME para abrir uma lista de candidatos. O parâmetro dwIndex especifica o índice da lista a ser aberta e dwValue não é usado. O IME enviará um comando IMN_OPENCANDIDATE para o aplicativo se ele abrir a lista.
NI_SELECTCANDIDATESTR	Um aplicativo selecionou um dos candidatos. O parâmetro dwIndex especifica um índice de uma lista de candidatos a ser selecionado. O parâmetro dwValue especifica um índice de uma cadeia de caracteres candidata na lista de candidatos selecionados.
NI_SETCANDIDATE_PAGESIZE	O aplicativo altera o tamanho da página de uma lista de candidatos. O parâmetro dwIndex especifica a lista de candidatos a ser alterada e deve ter um valor no intervalo de 0 a 3. O parâmetro dwValue especifica o novo tamanho da página.
NI_SETCANDIDATE_PAGESTART	O aplicativo altera o índice inicial da página de uma lista de candidatos. O parâmetro dwIndex especifica a lista de candidatos a ser alterada e deve ter um valor no intervalo de 0 a 3. O parâmetro dwValue especifica o novo índice de início de página.

[in] dwIndex

Índice de uma lista de candidatos. Como alternativa, se dwAction for NI_COMPOSITIONSTR, esse parâmetro poderá ter um dos valores a seguir.

Valor	Significado
CPS_CANCEL	Desmarque a cadeia de caracteres de composição e defina o status como nenhuma cadeia de caracteres de composição.
CPS_COMPLETE	Defina a cadeia de caracteres de composição como a cadeia de caracteres de resultado.
CPS_CONVERT	Converta a cadeia de caracteres de composição.
CPS_REVERT	Cancele a cadeia de caracteres de composição atual e defina a cadeia de caracteres de composição como a cadeia de caracteres não convertida.

[in] dwValue

Índice de uma cadeia de caracteres candidata. O aplicativo pode definir esse parâmetro ou ignorá-lo, dependendo do valor do parâmetro dwAction .

Retornar valor

Retorna diferente de zero se tiver êxito ou 0 de outra forma.

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

IMN_CLOSECANDIDATE

IMN_OPENCANDIDATE

Gerenciador de Métodos de Entrada

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

Compartilhar via