Partager via


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