IInkDisp ::ExtractWithRectangle, méthode (msinkaut.h)

Article
08/24/2023

Coupe ou copie les traits d’un objet InkDisp existant et les colle dans un nouvel objet InkDisp , en utilisant le rectangle connu pour déterminer les traits à extraire.

Syntaxe

HRESULT ExtractWithRectangle(
  [in]           IInkRectangle   *Rectangle,
  [in, optional] InkExtractFlags extractFlags,
  [out, retval]  IInkDisp        **ExtractedInk
);

Paramètres

[in] Rectangle

Spécifie l’objet InkRectangle qui délimite l’encre à extraire de l’objet InkDisp .

[in, optional] extractFlags

facultatif. Spécifie le type d’énumération InkExtractFlags , qui détermine si l’entrée manuscrite doit être coupée ou copiée à partir de l’objet InkDisp existant. La valeur par défaut est IEF_DEFAULT, qui coupe les traits de l’objet InkDisp existant.

[out, retval] ExtractedInk

Lorsque cette méthode est retournée, contient un pointeur vers un objet InkDisp qui contient la collection de traits extraite.

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_INK_EXCEPTION	Une exception s’est produite à l’intérieur de la méthode .
E_INK_SOME_STROKES_NOT_EXTRACTED	Tous les traits n’ont pas été extraits.
E_OUTOFMEMORY	Impossible d’allouer de la mémoire pour terminer l’opération.
E_INVALIDARG	Indicateurs d’extraction non valides.
REGDB_CLASSNOTREG	L’objet Ink n’a pas été inscrit.

Remarques

Le nouvel objet InkDisp conserve les attributs de dessin, les propriétés et les coordonnées de l’objet InkDisp d’origine.

Cette méthode est utile pour créer un objet InkDisp sans les traits supprimés ou coupés de l’objet d’origine.

Pour extraire des traits d’une collection connue de traits, appelez la méthode ExtractStrokes.

Seule la partie d’un trait qui se trouve dans le rectangle est ajoutée au nouvel objet InkDisp .

Lorsque le paramètre extractFlags est RemoveFromOriginal ou Default, tous les traits qui traversent le rectangle sont fractionnés et la partie du rectangle supprimée de l’objet InkDisp existant.

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