Structure CANDIDATELIST (imm.h)
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) |