Struttura CANDIDATELIST (immdev.h)
Contiene informazioni su un elenco di candidati.
Sintassi
typedef struct tagCANDIDATELIST {
DWORD dwSize;
DWORD dwStyle;
DWORD dwCount;
DWORD dwSelection;
DWORD dwPageStart;
DWORD dwPageSize;
DWORD dwOffset[1];
} CANDIDATELIST, *PCANDIDATELIST, *NPCANDIDATELIST, *LPCANDIDATELIST;
Members
dwSize
Dimensioni, in byte, della struttura, della matrice di offset e di tutte le stringhe candidate.
dwStyle
Valori dello stile candidato. Questo membro può avere uno o più dei valori seguenti.
| Valore | Significato |
|---|---|
| IME_CAND_UNKNOWN | I candidati sono in uno stile diverso da quello elencato qui. |
| IME_CAND_READ | I candidati sono nella stessa lettura. |
| IME_CAND_CODE | I candidati sono inclusi in un intervallo di codice. |
| IME_CAND_MEANING | I candidati hanno lo stesso significato. |
| IME_CAND_RADICAL | I candidati usano lo stesso carattere radicale. |
| IME_CAND_STROKES | I candidati sono nello stesso numero di tratti. |
Per lo stile di IME_CAND_CODE, l'elenco dei candidati ha una struttura speciale a seconda del valore del membro dwCount . Se dwCount è 1, il membro dwOffset contiene un singolo carattere DBCS anziché un offset e non viene fornita alcuna stringa candidata. Se il membro dwCount è maggiore di 1, il membro dwOffset contiene offset validi e le stringhe candidate sono rappresentazioni di testo di singoli valori di carattere DBCS in notazione esadecimale.
dwCount
Numero di stringhe candidate.
dwSelection
Indice della stringa candidata selezionata.
dwPageStart
Indice della prima stringa candidata nella finestra candidata. Ciò varia in base al fatto che l'utente preme i tasti PAGE UP e PAGE DOWN.
dwPageSize
Numero di stringhe candidate da visualizzare in una pagina nella finestra candidata. L'utente può passare alla pagina successiva premendo i tasti definiti dall'IME, ad esempio il tasto PAGE UP o PAGE DOWN. Se questo numero è 0, un'applicazione può definire un valore appropriato da solo.
dwOffset[1]
Offset all'inizio della prima stringa candidata, rispetto all'inizio di questa struttura. Gli offset per le stringhe successive seguono immediatamente questo membro, formando una matrice di offset a 32 bit.
Commenti
Le stringhe candidate seguono immediatamente l'ultimo offset nella matrice dwOffset .
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Intestazione | immdev.h (include Immdev.h, Windows.h) |