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)

Confira também

Gerenciador de Métodos de Entrada

Estruturas do Gerenciador de Métodos de Entrada