Funzione ImmGetProperty (imm.h)
Recupera le proprietà e le funzionalità dell'IME associate alle impostazioni locali di input specificate.
Sintassi
DWORD ImmGetProperty(
HKL unnamedParam1,
DWORD unnamedParam2
);
Parametri
unnamedParam1
unnamedParam2
Valore restituito
Restituisce il valore della proprietà o della funzionalità, a seconda del valore del parametro dwIndex . Se dwIndex è impostato su IGP_PROPERTY, la funzione restituisce uno o più dei valori seguenti:
| Valore | Significato |
|---|---|
| IME_PROP_AT_CARET | Se impostata, la finestra di conversione si trova nella posizione del cursore. Se cancella, la finestra si trova vicino alla posizione del cursore. |
| IME_PROP_SPECIAL_UI | Se impostato, L'IME ha un'interfaccia utente non standard. L'applicazione non deve disegnare nella finestra IME. |
| IME_PROP_CANDLIST_START_FROM_1 | Se impostata, le stringhe nell'elenco dei candidati vengono numerate a partire da 1. Se cancella, le stringhe iniziano a 0. |
| IME_PROP_UNICODE | Se impostato, l'IME viene visualizzato come IME Unicode. Il sistema operativo e l'IME comunicano tramite l'interfaccia IME Unicode. Se chiaro, l'IME usa l'interfaccia ANSI per comunicare con il sistema operativo. |
| IME_PROP_COMPLETE_ON_UNSELECT | Se impostato, L'IME completa la stringa di composizione quando l'IME viene disattivato. Se è chiaro, L'IME annulla la stringa di composizione quando l'IME viene disattivato, ad esempio da una modifica del layout della tastiera. |
| IME_PROP_ACCEPT_WIDE_VKEY | Se impostato, L'IME elabora l'Unicode inserito proveniente dalla funzione SendInput usando VK_PACKET. Se chiaro, l'IME potrebbe non elaborare l'Unicode inserito e potrebbe inviare direttamente l'Unicode inserito all'applicazione. |
Se dwIndex è impostato su IGP_UI, la funzione restituisce uno o più dei valori seguenti:
| Valore | Significato |
|---|---|
| UI_CAP_2700 | Supportare valori di escape del testo pari a 0 o 2700. Per altre informazioni, vedere il membro lfEscapement della struttura LOGFONT . |
| UI_CAP_ROT90 | Supportare valori di escape del testo pari a 0, 900, 1800 o 2700. Per altre informazioni, vedere lfEscapement. |
| UI_CAP_ROTANY | Supportare qualsiasi valore di escape del testo. Per altre informazioni, vedere lfEscapement. |
Se dwIndex è impostato su IGP_SETCOMPSTR, la funzione restituisce uno o più dei valori seguenti:
| Valore | Significato |
|---|---|
| SCS_CAP_COMPSTR | Creare la stringa di composizione chiamando la funzione ImmSetCompositionString con il valore SCS_SETSTR. |
| SCS_CAP_MAKEREAD | Creare la stringa di lettura dalla stringa di composizione corrispondente quando si usa la funzione ImmSetCompositionString con SCS_SETSTR e senza impostare lpRead. |
| SCS_CAP_SETRECONVERTSTRING: | Questo IME può supportare la riconversione. Usare ImmSetCompositionString per eseguire la riconversione. |
Se dwIndex è impostato su IGP_SELECT, la funzione restituisce uno o più dei valori seguenti:
| Valore | Significato |
|---|---|
| SELECT_CAP_CONVMODE | Ereditare la modalità di conversione quando viene selezionato un nuovo IME. |
| SELECT_CAP_SENTENCE | Ereditare la modalità frase quando viene selezionato un nuovo IME. |
Se dwIndex è impostato su IGP_GETIMEVERSION, la funzione restituisce uno o più dei valori seguenti:
| Valore | Significato |
|---|---|
| IMEVER_0310 | L'IME è stato creato per Windows 3.1. |
| IMEVER_0400 | L'IME è stato creato per Windows Me/98/95. |
Requisiti
| Requisito | Valore |
|---|---|
| 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 |