GetPreferredPacketDescription, fonction (recapis.h)

Récupère une description de paquet qui contient les propriétés de paquets que le module de reconnaissance utilise.

Syntaxe

HRESULT GetPreferredPacketDescription(
  HRECOGNIZER        hrec,
  PACKET_DESCRIPTION *pPacketDescription
);

Paramètres

hrec

Gérez le module de reconnaissance.

pPacketDescription

Décrit le contenu des paquets que le module de reconnaissance utilise. Pour plus d’informations, consultez la structure PACKET_DESCRIPTION .

Pour récupérer la description du paquet, initialisez la description du paquet avec zéros et appelez la fonction GetPreferredPacketDescription . La fonction remplit les nombres de propriétés et de boutons, que vous utilisez pour allouer de l’espace pour les membres pPacketProperties et pguidButtons de la structure PACKET_DESCRIPTION . Appelez à nouveau la fonction pour remplir le reste de la description du paquet.

Le membre pguidButtons de la structure PACKET_DESCRIPTION peut être égal à zéro lorsque GetPreferredPacketDescription est retourné. Cela signifie que les paquets n’ont pas de données de bouton, de sorte que ce membre n’a pas de pguidButtons alloués. Dans ce cas, la fonction appelante doit laisser le pointeur NULL.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Remarques

En règle générale, les générateurs de reconnaissance utilisent les propriétés de coordonnées (x, y) et ignorent les autres. Si vous enregistrez l’entrée manuscrite dans un fichier à des fins de reconnaissance ultérieurement, utilisez la description de paquet préférée pour enregistrer uniquement les propriétés utilisées par l’outil de reconnaissance.

Configuration requise

Voir aussi

AddStroke, fonction

PACKET_DESCRIPTION Structure