Funzione ImmNotifyIME (imm.h)

Articolo
08/24/2023

Notifica all'IME le modifiche apportate allo stato del contesto di input.

Sintassi

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

Parametri

unnamedParam1

[in] dwAction

Codice di notifica. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
NI_CHANGECANDIDATELIST	Un'applicazione ha modificato il candidato selezionato corrente. Il parametro dwIndex specifica un indice di un elenco candidato da selezionare e dwValue non viene usato.
NI_CLOSECANDIDATE	Un'applicazione indica all'IME di chiudere un elenco di candidati. Il parametro dwIndex specifica un indice dell'elenco da chiudere e dwValue non viene usato. L'IME invia un comando IMN_CLOSECANDIDATE all'applicazione se chiude l'elenco.
NI_COMPOSITIONSTR	Un'applicazione indirizza l'IME a eseguire un'azione sulla stringa di composizione. Il parametro dwIndex può essere CPS_CANCEL, CPS_COMPLETE, CPS_CONVERT o CPS_REVERT.
NI_IMEMENUSELECTED	Un'applicazione indirizza l'IME per consentire all'applicazione di gestire il menu specificato. Il parametro dwIndex specifica l'ID del menu e dwValue è un valore definito dall'applicazione per tale voce di menu.
NI_OPENCANDIDATE	Un'applicazione indica all'IME di aprire un elenco di candidati. Il parametro dwIndex specifica l'indice dell'elenco da aprire e dwValue non viene usato. L'IME invia un comando IMN_OPENCANDIDATE all'applicazione se apre l'elenco.
NI_SELECTCANDIDATESTR	Un'applicazione ha selezionato uno dei candidati. Il parametro dwIndex specifica un indice di un elenco candidato da selezionare. Il parametro dwValue specifica un indice di una stringa candidata nell'elenco dei candidati selezionati.
NI_SETCANDIDATE_PAGESIZE	L'applicazione modifica le dimensioni della pagina di un elenco candidato. Il parametro dwIndex specifica l'elenco dei candidati da modificare e deve avere un valore compreso nell'intervallo da 0 a 3. Il parametro dwValue specifica le nuove dimensioni della pagina.
NI_SETCANDIDATE_PAGESTART	L'applicazione modifica l'indice iniziale della pagina di un elenco candidato. Il parametro dwIndex specifica l'elenco dei candidati da modificare e deve avere un valore compreso nell'intervallo da 0 a 3. Il parametro dwValue specifica il nuovo indice iniziale della pagina.

[in] dwIndex

Indice di un elenco candidato. In alternativa, se dwAction è NI_COMPOSITIONSTR, questo parametro può avere uno dei valori seguenti.

Valore	Significato
CPS_CANCEL	Cancellare la stringa di composizione e impostare lo stato su nessuna stringa di composizione.
CPS_COMPLETE	Impostare la stringa di composizione come stringa di risultato.
CPS_CONVERT	Convertire la stringa di composizione.
CPS_REVERT	Annullare la stringa di composizione corrente e impostare la stringa di composizione come stringa non convertita.

[in] dwValue

Indice di una stringa candidata. L'applicazione può impostare questo parametro o ignorarlo, a seconda del valore del parametro dwAction .

Valore restituito

Restituisce un valore diverso da zero se ha esito positivo o 0 in caso contrario.

Requisiti


Client minimo supportato	Windows XP [solo app desktop],supporto per la lingua dell'Asia orientale installato.
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	imm.h (include Immdev.h, Windows.h)
Libreria	Imm32.lib
DLL	Imm32.dll

Vedi anche

IMN_CLOSECANDIDATE

IMN_OPENCANDIDATE

Gestione metodi di input

Funzioni di Gestione metodi di input

Share via