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

Article
02/29/2024

Récupère les données de paquets d’une plage de paquets dans l’objet IInkStrokeDisp .

Syntaxe

HRESULT GetPacketData(
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  VARIANT *PacketData
);

Paramètres

[in, optional] Index

Facultatif. Point de départ de l’index de base zéro vers 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 jeux de données de paquets de points qui doivent être retournés, en commençant par le paquet spécifié dans le paramètre startingIndex . 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] PacketData

Lorsque cette méthode est retournée, contient un tableau d’entiers 32 bits signé contenant les données de paquet pour les points demandés dans le trait. Le tableau contient les données du premier point, puis les données du deuxième point, et ainsi de suite.

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.
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 l’objet d’assistance du gestionnaire Stroke.
E_INVALIDARG	Le trait n’est pas valide.
E_INK_EXCEPTION	Une exception s’est produite à l’intérieur de la méthode .
E_UNEXPECTED	Paramètre ou type de propriété inattendu.

Remarques

Si le nombre de paquets dans le trait est inférieur à la somme des paramètres startingIndex et pointCount , le tableau de données retourné contient des informations sur les paquets pour moins de points que le nombre demandé.

Pour récupérer la description des données de paquets, utilisez la propriété PacketDescription du trait. Cette propriété retourne un tableau d’identificateur global unique (GUID) qui indique les valeurs de propriété retournées par la méthode GetPacketData pour chaque point. Les constantes PacketProperty contiennent les GUID de propriété de paquet disponibles.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP Édition Tablette 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