Estrutura CANDIDATELIST (imm.h)
Contém informações sobre uma lista de candidatos.
Sintaxe
typedef struct tagCANDIDATELIST {
DWORD dwSize;
DWORD dwStyle;
DWORD dwCount;
DWORD dwSelection;
DWORD dwPageStart;
DWORD dwPageSize;
DWORD dwOffset[1];
} CANDIDATELIST, *PCANDIDATELIST, *NPCANDIDATELIST, *LPCANDIDATELIST;
Membros
dwSize
Tamanho, em bytes, da estrutura, da matriz de deslocamento e de todas as cadeias de caracteres candidatas.
dwStyle
Valores de estilo de candidato. Esse membro pode ter um ou mais dos valores a seguir.
| Valor | Significado |
|---|---|
| IME_CAND_UNKNOWN | Os candidatos estão em um estilo diferente do listado aqui. |
| IME_CAND_READ | Os candidatos estão na mesma leitura. |
| IME_CAND_CODE | Os candidatos estão em um intervalo de código. |
| IME_CAND_MEANING | Os candidatos têm o mesmo significado. |
| IME_CAND_RADICAL | Os candidatos usam o mesmo caráter radical. |
| IME_CAND_STROKES | Os candidatos estão no mesmo número de traços. |
Para o estilo IME_CAND_CODE, a lista de candidatos tem uma estrutura especial dependendo do valor do membro dwCount . Se dwCount for 1, o membro dwOffset conterá um único caractere DBCS em vez de um deslocamento e nenhuma cadeia de caracteres candidata será fornecida. Se o membro dwCount for maior que 1, o membro dwOffset conterá deslocamentos válidos e as cadeias de caracteres candidatas serão representações de texto de valores de caractere DBCS individuais na notação hexadecimal.
dwCount
Número de cadeias de caracteres candidatas.
dwSelection
Índice da cadeia de caracteres candidata selecionada.
dwPageStart
Índice da primeira cadeia de caracteres candidata na janela candidata. Isso varia conforme o usuário pressiona as teclas PAGE UP e PAGE DOWN.
dwPageSize
Número de cadeias de caracteres candidatas a serem mostradas em uma página na janela do candidato. O usuário pode passar para a próxima página pressionando chaves definidas por IME, como a tecla PAGE UP ou PAGE DOWN. Se esse número for 0, um aplicativo poderá definir um valor adequado por si só.
dwOffset[1]
Deslocamento para o início da primeira cadeia de caracteres candidata, em relação ao início dessa estrutura. Os deslocamentos para cadeias de caracteres subsequentes seguem imediatamente esse membro, formando uma matriz de deslocamentos de 32 bits.
Comentários
As cadeias de caracteres candidatas seguem imediatamente o último deslocamento na matriz dwOffset .
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho | imm.h (inclua Immdev.h, Windows.h) |