Estructura CANDIDATELIST (imm.h)
Contiene información sobre una lista de candidatos.
Sintaxis
typedef struct tagCANDIDATELIST {
DWORD dwSize;
DWORD dwStyle;
DWORD dwCount;
DWORD dwSelection;
DWORD dwPageStart;
DWORD dwPageSize;
DWORD dwOffset[1];
} CANDIDATELIST, *PCANDIDATELIST, *NPCANDIDATELIST, *LPCANDIDATELIST;
Members
dwSize
Tamaño, en bytes, de la estructura, la matriz de desplazamiento y todas las cadenas candidatas.
dwStyle
Valores de estilo candidato. Este miembro puede tener uno o varios de los valores siguientes.
| Valor | Significado |
|---|---|
| IME_CAND_UNKNOWN | Los candidatos están en un estilo distinto del que se muestra aquí. |
| IME_CAND_READ | Los candidatos están en la misma lectura. |
| IME_CAND_CODE | Los candidatos están en un intervalo de código. |
| IME_CAND_MEANING | Los candidatos tienen el mismo significado. |
| IME_CAND_RADICAL | Los candidatos usan el mismo carácter radical. |
| IME_CAND_STROKES | Los candidatos están en el mismo número de trazos. |
Para el estilo IME_CAND_CODE, la lista candidata tiene una estructura especial en función del valor del miembro dwCount . Si dwCount es 1, el miembro dwOffset contiene un solo carácter DBCS en lugar de un desplazamiento y no se proporciona ninguna cadena candidata. Si el miembro dwCount es mayor que 1, el miembro dwOffset contiene desplazamientos válidos y las cadenas candidatas son representaciones de texto de valores de caracteres DBCS individuales en notación hexadecimal.
dwCount
Número de cadenas candidatas.
dwSelection
Índice de la cadena candidata seleccionada.
dwPageStart
Índice de la primera cadena candidata en la ventana candidata. Esto varía a medida que el usuario presiona las teclas PAGE UP y PAGE DOWN.
dwPageSize
Número de cadenas candidatas que se mostrarán en una página de la ventana candidata. El usuario puede pasar a la página siguiente presionando teclas definidas por IME, como la tecla PAGE UP o PAGE DOWN. Si este número es 0, una aplicación puede definir un valor adecuado por sí mismo.
dwOffset[1]
Desplazamiento hasta el inicio de la primera cadena candidata, en relación con el inicio de esta estructura. Los desplazamientos de las cadenas posteriores siguen inmediatamente a este miembro, formando una matriz de desplazamientos de 32 bits.
Comentarios
Las cadenas candidatas siguen inmediatamente el último desplazamiento de la matriz dwOffset .
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado | imm.h (incluya Immdev.h, Windows.h) |