Función ImmNotifyIME (immdev.h)

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 siguientes valores.

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 dwValue no se usa.
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 dwValue no se usa. 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 de candidatos 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 siguientes valores.

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 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, en función del valor del parámetro dwAction .

Valor devuelto

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

Requisitos

Requisito	Value
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	immdev.h (incluya 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