IInkStrokeDisp::Clip, méthode (msinkaut.h)

Supprime des parties d’un objet IInkStrokeDisp ou d’une collection InkStrokes qui se trouvent en dehors d’un rectangle.

Syntaxe

HRESULT Clip(
  [in] IInkRectangle *Rectangle
);

Paramètres

[in] Rectangle

Spécifie le rectangle à l’extérieur duquel le ou les traits sont coupés. Le rectangle est spécifié en coordonnées d’espace d’entrée manuscrite.

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.
REGDB_CLASSNOTREG	L’objet InkDisp n’est pas inscrit.
E_INVALIDARG	Rectangle de clip non valide.
E_INK_EXCEPTION	Une exception s’est produite à l’intérieur de la méthode .
E_FAIL	Une erreur non spécifiée s'est produite.

Notes

Pour un objet InkDisp , tous les traits croisés par le rectangle sont fractionnés aux points d’intersection. Toutes les parties des traits en dehors du rectangle sont supprimées de l’objet InkDisp . La méthode peut ajouter de nouveaux points à un trait au point où le trait croise le rectangle. Après avoir appelé la méthode Clip sur un objet InkDisp , les ID des traits de la collection de traits de l’objet InkDisp sont garantis comme étant uniques, mais pas garantis pour conserver d’autres informations.

Cette méthode ne prend pas en compte la largeur du stylet lors du découpage. Il extrait uniquement les données d’entrée manuscrite ou de trait réelles.

Pour un objet IInkStrokeDisp ou une collection InkStrokes , la méthode Clip met à jour l’objet InkDisp parent. Chaque fois que l’entrée manuscrite est supprimée d’un objet InkDisp , les objets IInkStrokeDisp ou les collections InkStrokes définies pour cet objet InkDisp peuvent être invalidés.

Pour plus d’informations sur les données manuscrites, consultez Données manuscrites.

Spécifications

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

HitTest(Rectangle, Single), méthode

IInkStrokeDisp, interface

InkRectangle, classe