Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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) |