CANDIDATELIST-Struktur (immdev.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 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)

Weitere Informationen

Eingabemethoden-Manager

Eingabemethoden-Manager-Strukturen

Share via