Função GetPreferredPacketDescription (recapis.h)

Recupera uma descrição de pacote que contém as propriedades de pacote que o reconhecedor usa.

Sintaxe

HRESULT GetPreferredPacketDescription(
  HRECOGNIZER        hrec,
  PACKET_DESCRIPTION *pPacketDescription
);

Parâmetros

hrec

Identificador para o reconhecedor.

pPacketDescription

Descreve o conteúdo dos pacotes que o reconhecedor usa. Para obter mais informações, consulte a estrutura PACKET_DESCRIPTION .

Para recuperar a descrição do pacote, inicialize a descrição do pacote com zeros e chame a função GetPreferredPacketDescription . A função preenche a propriedade e as contagens de botões, que você usa para alocar espaço para os membros pPacketProperties e pguidButtons da estrutura PACKET_DESCRIPTION . Chame a função novamente para preencher o restante da descrição do pacote.

O membro pguidButtons da estrutura PACKET_DESCRIPTION pode ser zero quando GetPreferredPacketDescription retorna. Isso significa que os pacotes não têm dados de botão, portanto, esse membro não tem nenhum pguidButtons alocado. Nesse caso, a função de chamada deve deixar o ponteiro NULL.

Retornar valor

Essa função pode retornar um desses valores.

Comentários

Normalmente, os reconhecedores usam as propriedades de coordenadas (x, y) e ignoram as outras. Se você salvar a tinta em um arquivo para reconhecimento posteriormente, use a descrição de pacote preferencial para salvar apenas as propriedades que o reconhecedor usa.

Requisitos

Confira também

Função AddStroke

Estrutura PACKET_DESCRIPTION