Méthode IInkStrokeDisp ::GetPacketValuesByProperty (msinkaut.h)

Article
02/29/2024

Récupère les données d’une propriété de paquet connue à partir d’un ou plusieurs paquets dans le trait.

Syntaxe

HRESULT GetPacketValuesByProperty(
  [in]           BSTR    PropertyName,
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  VARIANT *PacketValues
);

Paramètres

[in] PropertyName

Identificateur des constantes PacketProperty utilisées pour sélectionner les données de paquets récupérées.

Pour plus d’informations sur le type de données BSTR, consultez Utilisation de la bibliothèque COM.

[in, optional] Index

facultatif. Point de départ de l’index de base zéro d’un paquet dans le trait. La valeur par défaut ISC_FirstElement, définie dans le type d’énumération InkSelectionConstants , spécifie le premier paquet.

[in, optional] Count

facultatif. Nombre de points qui composent les données de trait. La valeur par défaut ISC_AllElements, définie dans le type d’énumération InkSelectionConstants , spécifie tous les points qui composent les données de trait.

[out, retval] PacketValues

Lorsque cette méthode retourne, contient un tableau d’entiers 32 bits signés qui spécifie la valeur du PacketProperty demandé pour chaque point demandé à partir du trait.

Pour plus d’informations sur la structure VARIANT, consultez Utilisation de la bibliothèque COM.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	Réussite.
TPC_E_INVALID_STROKE	Le trait n’est pas valide.
E_POINTER	Un paramètre contenait un pointeur non valide.
E_FAIL	Une erreur non spécifiée s'est produite.
E_OUTOFMEMORY	Impossible d’allouer un tableau de données de paquets.
E_INVALIDARG	Index, nombre ou propriété de paquet non valide.
E_INK_EXCEPTION	Une exception s’est produite à l’intérieur de la méthode.
CO_E_CLASSSTRING	Format GUID non valide.

Remarques

Une propriété de paquet spécifique peut ne pas être disponible sur un objet IInkStrokeDisp particulier. Un Tablet PC peut avoir plusieurs tablettes pour l’entrée utilisateur. La collection InkTablets contient une liste de toutes les tablettes attachées au Tablet PC. Utilisez la méthode IsPacketPropertySupported pour déterminer si une propriété de paquet particulière est prise en charge par un objet IInkTablet spécifique ou par toutes les tablettes disponibles. Utilisez également la propriété DesiredPacketDescription du collecteur d’encre pour contrôler les propriétés de paquets collectées sur les nouveaux traits.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP Édition Tablet PC [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	msinkaut.h
Bibliothèque	InkObj.dll