Condividi tramite

Funzione ImmNotifyIME (imm.h)

  • Articolo

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