Funzione ImmGetCompositionStringA (imm.h)

Articolo
11/20/2024

Recupera informazioni sulla stringa di composizione.

Sintassi

LONG ImmGetCompositionStringA(
                  HIMC   unnamedParam1,
                  DWORD  unnamedParam2,
  [out, optional] LPVOID lpBuf,
  [in]            DWORD  dwBufLen
);

Parametri

unnamedParam1

unnamedParam2

[out, optional] lpBuf

Puntatore a un buffer in cui la funzione recupera le informazioni sulla stringa di composizione.

[in] dwBufLen

Dimensioni, in byte, del buffer di output, anche se l'output è una stringa Unicode. L'applicazione imposta questo parametro su 0 se la funzione restituisce le dimensioni del buffer di output richiesto.

Valore restituito

Restituisce il numero di byte copiati nel buffer di output. Se dwBufLen è impostato su 0, la funzione restituisce le dimensioni del buffer, in byte, necessarie per ricevere tutte le informazioni richieste, escluso il carattere Null di terminazione. Il valore restituito è sempre la dimensione, in byte, anche se i dati richiesti sono una stringa Unicode.

Questa funzione restituisce uno dei codici di errore negativi seguenti se non riesce:

IMM_ERROR_NODATA. I dati di composizione non sono pronti nel contesto di input.
IMM_ERROR_GENERAL. Errore generale rilevato da IME.

Osservazioni

Un'applicazione chiama questa funzione in risposta al messaggio WM_IME_COMPOSITION o WM_IME_STARTCOMPOSITION. IMM rimuove le informazioni quando l'applicazione chiama la funzione ImmReleaseContext .

Nota È necessario scrivere codice per gestire Sia Hiragana a larghezza intera che katakana a metà larghezza se l'applicazione viene usata con il pannello di input soft (SIP).

Nota

L'intestazione imm.h definisce ImmGetCompositionString come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop],è installato il supporto per la lingua dell'Asia orientale.
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	imm.h (include Immdev.h, Windows.h)
libreria	Imm32.lib
dll	Imm32.dll

Vedere anche

ImmReleaseContext

di Gestione metodi di input

funzioni di Gestione metodi di input

WM_IME_COMPOSITION

WM_IME_STARTCOMPOSITION

Condividi tramite