Funzione SendIMEMessageExA (ime.h)

Articolo
08/24/2023

[Questa funzione è obsoleta e non deve essere usata.]

Specifica un'azione o un'elaborazione per l'editor di metodi di input (IME) tramite una sottofunzione specificata.

Sintassi

LRESULT SendIMEMessageExA(
       HWND   unnamedParam1,
       LPARAM unnamedParam2
);

Parametri

unnamedParam1

unnamedParam2

Valore restituito

Risultato dell'elaborazione della sottofunzione. Se il risultato non ha esito positivo, uno dei codici di errore seguenti viene archiviato nel wParam della struttura IMESTRUCT .

Codice restituito	Descrizione
IME_RS_DISKERROR	Errore del disco.
IME_RS_ERROR	Errore generale.
IME_RS_ILLEGAL	Contiene un carattere non valido.
IME_RS_INVALID	Sottofunzione non valida.
IME_RS_NEST	La sottofunzione è annidata e, pertanto, non può essere usata.
IME_RS_NOIME	L'IME non è stato selezionato (non è stato installato).
IME_RS_NOROOM	Breve area.
IME_RS_NOTFOUND	Nessun candidato trovato.
IME_RS_SYSTEMMODAL	Windows è in modalità di sistema, i dati non possono essere passati all'IME.
IME_RS_TOOLONG	Caratteri troppo lunghi.

Commenti

SendIMEMessageEx garantisce l'azione stabilita nelle specifiche solo per gli IMES che supportano il messaggio di WM_CONVERTREQUESTEX . Per un IME che non supporta WM_CONVERTREQUESTEX, SendIMEMessageEx invia un messaggio di WM_CONVERTREQUEST all'IME e restituisce il contenuto del membro wParam della struttura IMESTRUCT . Se l'elaborazione della sottofunzione non è stata completata normalmente, queste funzioni impostano IME_RS_ERROR in wParam.

Nota

L'intestazione ime.h definisce SendIMEMessageEx 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 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ime.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll

Condividi tramite