Partager via


Méthode IInkDisp ::Clip (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 trait ou les traits sont coupés. Le rectangle est spécifié dans les coordonnées de l’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.

Remarques

Pour un objet InkDisp , tous les traits croisés par le rectangle sont fractionnés aux points d’intersection. Toutes les parties de 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 uniques, mais pas garantis pour conserver d’autres informations.

Cette méthode ne tient pas compte de la largeur du stylet lors du découpage. Il clipse uniquement les données d’encre 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.

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

Voir aussi

Méthode HitTest(Rectangle, Single)

IInkDisp

Classe InkDisp

Classe InkRectangle