CANDIDATELIST-Struktur (immdev.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 Bytes.
dwStyle
Kandidatenstilwerte. Dieses Element kann mindestens einen der folgenden Werte aufweisen.
| Wert | Bedeutung |
|---|---|
| IME_CAND_UNKNOWN | Kandidaten sind in einem anderen Stil als hier aufgeführt. |
| IME_CAND_READ | Kandidaten befinden sich in derselben Lesart. |
| IME_CAND_CODE | Kandidaten befinden sich in einem Codebereich. |
| IME_CAND_MEANING | Kandidaten haben dieselbe Bedeutung. |
| IME_CAND_RADICAL | Kandidaten verwenden dasselbe radikale Zeichen. |
| IME_CAND_STROKES | Kandidaten haben die gleiche Anzahl von Strichen. |
Für den IME_CAND_CODE-Format weist die Kandidatenliste eine spezielle Struktur auf, die vom Wert des dwCount-Elements abhängt. Wenn dwCount 1 ist, enthält das dwOffset-Element ein einzelnes DBCS-Zeichen anstelle eines Offsets, und es wird keine Kandidatenzeichenfolge angegeben. 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 Notation.
dwCount
Anzahl der Kandidatenzeichenfolgen.
dwSelection
Index der ausgewählten Kandidatenzeichenfolge.
dwPageStart
Index der ersten Kandidatenzeichenfolge im Kandidatenfenster. Dies variiert, wenn der Benutzer die TASTE PAGE UP und PAGE DOWN 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 im IME-definierten Schlüssel drückt, z. B. die TASTE "PAGE UP" oder "PAGE DOWN". Wenn diese Zahl 0 ist, kann eine Anwendung selbst einen richtigen Wert definieren.
dwOffset[1]
Offset auf den Anfang der ersten Kandidatenzeichenfolge relativ zum Anfang dieser Struktur. Die Offsets für nachfolgende Zeichenfolgen folgen sofort diesem Member und bilden ein Array von 32-Bit-Offsets.
Hinweise
Die Kandidatenzeichenfolgen folgen unmittelbar dem letzten Offset im array dwOffset .
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Kopfzeile | immdev.h (einschließen immdev.h, Windows.h) |