CANDIDATELIST-Struktur (imm.h)

Artikel
08/24/2023

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)

Weitere Informationen

Eingabemethoden-Manager

Strukturen des Eingabemethoden-Managers

Share via