Структура CANDIDATELIST (imm.h)
Содержит сведения о списке кандидатов.
Синтаксис
typedef struct tagCANDIDATELIST {
DWORD dwSize;
DWORD dwStyle;
DWORD dwCount;
DWORD dwSelection;
DWORD dwPageStart;
DWORD dwPageSize;
DWORD dwOffset[1];
} CANDIDATELIST, *PCANDIDATELIST, *NPCANDIDATELIST, *LPCANDIDATELIST;
Члены
dwSize
Размер (в байтах) структуры, массива смещения и всех строк-кандидатов.
dwStyle
Значения стилей кандидатов. Этот элемент может иметь одно или несколько из следующих значений.
| Значение | Значение |
|---|---|
| IME_CAND_UNKNOWN | Кандидаты имеют стиль, отличный от перечисленных здесь. |
| IME_CAND_READ | Кандидаты находятся в одном чтении. |
| IME_CAND_CODE | Кандидаты находятся в диапазоне кода. |
| IME_CAND_MEANING | Кандидаты в том же значении. |
| IME_CAND_RADICAL | Кандидаты используют один и тот же радикальный характер. |
| IME_CAND_STROKES | Кандидаты имеют одинаковое количество штрихов. |
Для стиля IME_CAND_CODE список кандидатов имеет специальную структуру в зависимости от значения элемента dwCount . Если значение dwCount равно 1, элемент dwOffset содержит один символ DBCS, а не смещение, и строка-кандидат не указана. Если элемент dwCount больше 1, то элемент dwOffset содержит допустимые смещения, а строки-кандидаты представляют собой текстовые представления отдельных символьных значений DBCS в шестнадцатеричной нотации.
dwCount
Число строк-кандидатов.
dwSelection
Индекс выбранной строки-кандидата.
dwPageStart
Индекс первой строки кандидата в окне кандидата. Это зависит от того, как пользователь нажимает клавиши PAGE UP и PAGE DOWN.
dwPageSize
Количество строк-кандидатов, отображаемых на одной странице в окне кандидата. Пользователь может перейти на следующую страницу, нажав клавиши, определяемые IME, например PAGE UP или PAGE DOWN. Если это число равно 0, приложение может самостоятельно определить правильное значение.
dwOffset[1]
Смещение до начала первой строки-кандидата относительно начала этой структуры. Смещения для последующих строк сразу следуют за этим элементом, образуя массив 32-разрядных смещений.
Комментарии
Строки-кандидаты сразу следуют за последним смещением в массиве dwOffset .
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхняя часть | imm.h (включая Immdev.h, Windows.h) |