CANDIDATELIST-Struktur (imm.h)
Enthält Informationen zu einer Kandidatenliste.
Syntax
typedef struct tagCANDIDATELIST {
DWORD dwSize;
DWORD dwStyle;
DWORD dwCount;
DWORD dwSelection;
DWORD dwPageStart;
DWORD dwPageSize;
DWORD dwOffset[1];
} CANDIDATELIST, *PCANDIDATELIST, *NPCANDIDATELIST, *LPCANDIDATELIST;
Members
dwSize
Größe der Struktur, des Offsetarrays und aller Kandidatenzeichenfolgen in Byte.
dwStyle
Kandidatenformatwerte. Dieser Member kann über einen oder mehrere der folgenden Werte verfügen.
| Wert | Bedeutung |
|---|---|
| IME_CAND_UNKNOWN | Kandidaten haben einen anderen Stil als hier aufgeführt. |
| IME_CAND_READ | Die Kandidaten befinden sich in derselben Lektüre. |
| IME_CAND_CODE | Kandidaten befinden sich in einem Codebereich. |
| IME_CAND_MEANING | Kandidaten haben dieselbe Bedeutung. |
| IME_CAND_RADICAL | Kandidaten verwenden denselben radikalen Charakter. |
| IME_CAND_STROKES | Kandidaten haben die gleiche Anzahl von Strichen. |
Für das IME_CAND_CODE-Format verfügt die Kandidatenliste abhängig vom Wert des dwCount-Elements über eine spezielle Struktur. Wenn dwCount 1 ist, enthält das dwOffset-Element ein einzelnes DBCS-Zeichen anstelle eines Offsets, und es wird keine Kandidatenzeichenfolge bereitgestellt. Wenn das dwCount-Element größer als 1 ist, enthält das dwOffset-Element gültige Offsets, und die Kandidatenzeichenfolgen sind Textdarstellungen einzelner DBCS-Zeichenwerte in hexadezimaler Schreibweise.
dwCount
Anzahl der Kandidatenzeichenfolgen.
dwSelection
Index der ausgewählten Kandidatenzeichenfolge.
dwPageStart
Index der ersten Kandidatenzeichenfolge im Kandidatenfenster. Dies variiert, wenn der Benutzer die SEITEN-NACH-OBEN- und BILD-NACH-UNTEN-TASTE drückt.
dwPageSize
Anzahl der Kandidatenzeichenfolgen, die auf einer Seite im Kandidatenfenster angezeigt werden sollen. Der Benutzer kann zur nächsten Seite wechseln, indem er IME-definierte Tasten drückt, z. B. die AUS-OBEN- oder DIE BILD-NACH-UNTEN-TASTE. Wenn diese Zahl 0 ist, kann eine Anwendung selbst einen richtigen Wert definieren.
dwOffset[1]
Offset zum Anfang der ersten Kandidatenzeichenfolge relativ zum Anfang dieser Struktur. Die Offsets für nachfolgende Zeichenfolgen folgen unmittelbar diesem Member und bilden ein Array von 32-Bit-Offsets.
Hinweise
Die Kandidatenzeichenfolgen folgen unmittelbar auf den letzten Offset im dwOffset-Array .
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Kopfzeile | imm.h (include Immdev.h, Windows.h) |