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)

Consulte también

Administrador de métodos de entrada

Estructuras del Administrador de métodos de entrada