Structure CANDIDATELIST (imm.h)

Article
08/24/2023

Contient des informations sur une liste de candidats.

Syntaxe

typedef struct tagCANDIDATELIST {
  DWORD dwSize;
  DWORD dwStyle;
  DWORD dwCount;
  DWORD dwSelection;
  DWORD dwPageStart;
  DWORD dwPageSize;
  DWORD dwOffset[1];
} CANDIDATELIST, *PCANDIDATELIST, *NPCANDIDATELIST, *LPCANDIDATELIST;

Membres

dwSize

Taille, en octets, de la structure, du tableau de décalage et de toutes les chaînes candidates.

dwStyle

Valeurs de style candidat. Ce membre peut avoir une ou plusieurs des valeurs suivantes.

Valeur	Signification
IME_CAND_UNKNOWN	Les candidats sont dans un style autre que celui répertorié ici.
IME_CAND_READ	Les candidats sont dans la même lecture.
IME_CAND_CODE	Les candidats se trouvent dans une plage de code.
IME_CAND_MEANING	Les candidats ont le même sens.
IME_CAND_RADICAL	Les candidats utilisent le même caractère radical.
IME_CAND_STROKES	Les candidats ont le même nombre de traits.

Pour le style IME_CAND_CODE, la liste candidate a une structure spéciale en fonction de la valeur du membre dwCount . Si dwCount a la valeur 1, le membre dwOffset contient un seul caractère DBCS plutôt qu’un décalage, et aucune chaîne candidate n’est fournie. Si le membre dwCount est supérieur à 1, le membre dwOffset contient des décalages valides et les chaînes candidates sont des représentations textuelles de valeurs de caractères DBCS individuelles en notation hexadécimale.

dwCount

Nombre de chaînes candidates.

dwSelection

Index de la chaîne candidate sélectionnée.

dwPageStart

Index de la première chaîne candidate dans la fenêtre candidate. Cela varie lorsque l’utilisateur appuie sur les touches PAGE HAUT et PAGE BAS.

dwPageSize

Nombre de chaînes candidates à afficher dans une page dans la fenêtre candidate. L’utilisateur peut passer à la page suivante en appuyant sur les touches définies par l’IME, telles que la touche PAGE HAUT ou PAGE BAS. Si ce nombre est 0, une application peut définir une valeur appropriée par elle-même.

dwOffset[1]

Décalage vers le début de la première chaîne candidate, par rapport au début de cette structure. Les décalages des chaînes suivantes suivent immédiatement ce membre, formant un tableau de décalages 32 bits.

Notes

Les chaînes candidates suivent immédiatement le dernier décalage dans le tableau dwOffset .

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	imm.h (inclure Immdev.h, Windows.h)

Voir aussi

Gestionnaire de méthodes d’entrée

Structures du gestionnaire de méthodes d’entrée

Partager via