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.

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

Confira também

Gerenciador de Métodos de Entrada

Estruturas do Gerenciador de Métodos de Entrada