Função ImmNotifyIME (imm.h)

  • Artigo

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 .

Valor retornado

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

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

IMN_CLOSECANDIDATE

IMN_OPENCANDIDATE

Gerenciador de Métodos de Entrada

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