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

Article
03/06/2024

Définit les points du IInkStrokeDisp à l’aide d’un tableau de valeurs X, Y.

Syntaxe

HRESULT SetPoints(
  [in]           VARIANT Points,
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  long    *NumberOfPointsSet
);

Paramètres

[in] Points

Tableau de nouveaux points à remplacer dans le trait à partir de l’index. Il s’agit d’un variant contenant un tableau de Long avec les points représentés par des valeurs alternées de la forme x0, y0, x1, y1, x2, y2, etc.

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

[in, optional] Index

facultatif. Index de base zéro du premier point du trait à modifier. La valeur par défaut ISC_FirstElement, définie dans le type d’énumération ItemSelectionConstants , spécifie que le premier point du trait est modifié.

[in, optional] Count

facultatif. Nombre de points dans le trait à modifier. La valeur par défaut ISC_AllElements, définie dans le type d’énumération ItemSelectionConstants , spécifie que tous les points du trait sont modifiés.

[out, retval] NumberOfPointsSet

Lorsque cette méthode est retournée, contient le nombre réel de paquets définis.

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_INVALIDARG	Index non valide (hors plage) ou paramètre de points. N’était pas dans le format correct.
E_INK_EXCEPTION	Une exception s’est produite à l’intérieur de la méthode .

Remarques

Cette méthode ne modifie pas le nombre de points dans le trait. Pour modifier le nombre de points dans le trait, un nouveau trait doit être créé ou le trait doit être fractionné.

Cette méthode ne permet pas de tronquer le trait. Si le tableau de points contient moins de points que le trait, le reste des points du trait ne sont pas modifiés.

Cette méthode ne permet pas d’étendre le trait. Si le tableau de points contient plus de points que le trait, les points supplémentaires ne sont pas utilisés. Si le nombre dépasse le nombre de points dans le tableau, seul le nombre de points dans le tableau est modifié.

Pour dessiner le trait après avoir appelé SetPoints, appelez la fonction InvalidateRect .

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

Voir aussi

IInkStrokeDisp, interface

ItemSelectionConstants, énumération

Partager via