Función ImmNotifyIME (imm.h)

  • Artículo

Notifica al IME los cambios en el estado del contexto de entrada.

Sintaxis

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

Parámetros

unnamedParam1

[in] dwAction

Código de notificación. Este parámetro puede tener uno de los valores siguientes.

Valor Significado
NI_CHANGECANDIDATELIST
 Una aplicación cambió el candidato seleccionado actual. El parámetro dwIndex especifica un índice de una lista candidata que se va a seleccionar y no se usa dwValue .
NI_CLOSECANDIDATE
 Una aplicación dirige al IME para cerrar una lista de candidatos. El parámetro dwIndex especifica un índice de la lista que se va a cerrar y no se usa dwValue . El IME envía un comando IMN_CLOSECANDIDATE a la aplicación si cierra la lista.
NI_COMPOSITIONSTR
 Una aplicación dirige al IME para llevar a cabo una acción en la cadena de composición. El parámetro dwIndex puede ser CPS_CANCEL, CPS_COMPLETE, CPS_CONVERT o CPS_REVERT.
NI_IMEMENUSELECTED
 Una aplicación dirige el IME para permitir que la aplicación controle el menú especificado. El parámetro dwIndex especifica el identificador del menú y dwValue es un valor definido por la aplicación para ese elemento de menú.
NI_OPENCANDIDATE
 Una aplicación dirige al IME para abrir una lista de candidatos. El parámetro dwIndex especifica el índice de la lista que se va a abrir y dwValue no se usa. El IME envía un comando IMN_OPENCANDIDATE a la aplicación si abre la lista.
NI_SELECTCANDIDATESTR
 Una aplicación ha seleccionado uno de los candidatos. El parámetro dwIndex especifica un índice de una lista candidata que se va a seleccionar. El parámetro dwValue especifica un índice de una cadena candidata en la lista candidata seleccionada.
NI_SETCANDIDATE_PAGESIZE
 La aplicación cambia el tamaño de página de una lista candidata. El parámetro dwIndex especifica la lista candidata que se va a cambiar y debe tener un valor en el intervalo de 0 a 3. El parámetro dwValue especifica el nuevo tamaño de página.
NI_SETCANDIDATE_PAGESTART
 La aplicación cambia el índice inicial de la página de una lista candidata. El parámetro dwIndex especifica la lista candidata que se va a cambiar y debe tener un valor en el intervalo de 0 a 3. El parámetro dwValue especifica el nuevo índice de inicio de página.

[in] dwIndex

Índice de una lista candidata. Como alternativa, si dwAction es NI_COMPOSITIONSTR, este parámetro puede tener uno de los valores siguientes.

Valor Significado
CPS_CANCEL
 Borre la cadena de composición y establezca el estado en ninguna cadena de composición.
CPS_COMPLETE
 Establezca la cadena de composición como la cadena de resultado.
CPS_CONVERT
 Convierta la cadena de composición.
CPS_REVERT
 Cancele la cadena de composición actual y establezca la cadena de composición para que sea la cadena sin convertir.

[in] dwValue

Índice de una cadena candidata. La aplicación puede establecer este parámetro o omitirlo, según el valor del parámetro dwAction .

Valor devuelto

Devuelve un valor distinto de cero si se ejecuta correctamente o 0 de lo contrario.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio],compatibilidad con idiomas del Este asiático instaladas.
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado imm.h (incluye Immdev.h, Windows.h)
Library Imm32.lib
Archivo DLL Imm32.dll

Consulte también

IMN_CLOSECANDIDATE

IMN_OPENCANDIDATE

Administrador de métodos de entrada

Funciones del Administrador de métodos de entrada