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.

Código de retorno	Descrição
S_OK	Êxito.
E_POINTER	O parâmetro é um ponteiro inválido.
TPC_E_INSUFFICIENT_BUFFER	O buffer pPacketDescription é muito pequeno.
E_FAIL	Ocorreu um erro não especificado.
E_INVALIDARG	Um argumento inválido foi recebido.

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

Requisito	Valor
Cliente mínimo com suporte	Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	recapis.h
DLL	inkobjcore.dll

Confira também

Função AddStroke

Estrutura PACKET_DESCRIPTION