Funzione ImmGetConversionListA (imm.h)

Articolo
08/24/2023

Recupera l'elenco dei risultati della conversione di caratteri o parole senza generare messaggi correlati a IME.

Sintassi

DWORD ImmGetConversionListA(
        HKL             unnamedParam1,
        HIMC            unnamedParam2,
  [in]  LPCSTR          lpSrc,
  [out] LPCANDIDATELIST lpDst,
  [in]  DWORD           dwBufLen,
  [in]  UINT            uFlag
);

Parametri

unnamedParam1

unnamedParam2

[in] lpSrc

Puntatore a una stringa di caratteri con terminazione null specificando l'origine dell'elenco.

[out] lpDst

Puntatore a una struttura CANDIDATELIST in cui la funzione recupera l'elenco.

[in] dwBufLen

Dimensioni, in byte, del buffer di output. L'applicazione imposta questo parametro su 0 se la funzione restituisce le dimensioni del buffer necessarie per l'elenco completo dei risultati di conversione.

[in] uFlag

Flag di azione. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
GCL_CONVERSION	La stringa di origine è la stringa di lettura. La funzione copia la stringa di risultato nel buffer di destinazione.
GCL_REVERSECONVERSION	La stringa di origine è la stringa di risultato. La funzione copia la stringa di lettura nel buffer di destinazione.
GCL_REVERSE_LENGTH	La stringa di origine è la stringa di risultato. La funzione restituisce le dimensioni, in byte, della stringa di lettura creata se viene specificata GCL_REVERSECONVERSION.

Valore restituito

Restituisce il numero di byte copiati nel buffer di output. Se l'applicazione imposta il parametro dwBufLen su 0, la funzione restituisce le dimensioni, in byte, del buffer di output richiesto.

Commenti

Nota

L'intestazione imm.h definisce ImmGetConversionList come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti


Client minimo supportato	Windows XP [solo app desktop], supporto per la lingua asiatica 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

CANDIDATOLIST

Gestione metodi di input

Funzioni di Gestione metodi di input

Condividi tramite