Struttura CANDIDATELIST (imm.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 di stile candidati. 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 si trovano nella stessa lettura.
IME_CAND_CODE	I candidati si trovano in un intervallo di codice.
IME_CAND_MEANING	I candidati sono nello 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 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 candidato. Se il membro dwCount è maggiore di 1, il membro dwOffset contiene offset validi e le stringhe candidate sono rappresentazioni di testo dei singoli valori di carattere DBCS nella notazione esadecimale.

dwCount

Numero di stringhe candidate.

dwSelection

Indice della stringa candidato selezionata.

dwPageStart

Indice della prima stringa candidato nella finestra dei candidati. Ciò varia quando l'utente preme i tasti PAGE UP e PAGE DOWN.

dwPageSize

Numero di stringhe candidate da visualizzare in una pagina nella finestra dei candidati. L'utente può passare alla pagina successiva premendo tasti definiti da 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 candidato, 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	imm.h (include Immdev.h, Windows.h)

Vedi anche

Gestione metodi di input

Strutture di Gestione metodi di input