InkDisp, classe

Représente les traits d’encre collectés dans un espace d’encre.

InkDisp possède les types de membres suivants :

Événements

La classe InkDisp contient ces événements.

Événement Description
InkAdded Se produit lorsqu’un trait est ajouté à l’objet InkDisp .
InkDeleted Se produit lorsqu’un trait est supprimé de l’objet InkDisp .

Interfaces

La classe InkDisp définit ces interfaces.

Interface Description
IInkDisp Cet objet implémente l’interface com IInkDisp .

Méthodes

La classe InkDisp possède ces méthodes.

Méthode Description
AddStrokesAtRectangle Insère une collection de traits dans l’objet InkDisp au niveau du rectangle spécifié.
CanPaste Indique si IDataObject peut être converti en objet InkDisp .
Clip Supprime des parties d’un trait ou d’une collection de traits situés à l’extérieur d’un rectangle.
ClipboardCopy Copie la collection InkStrokes dans le presse-papiers.
ClipboardCopyWithRectangle Copie les objets IInkStrokeDisp contenus dans le rectangle connu dans le presse-papiers.
ClipboardPaste Copie IDataObject du presse-papiers vers l’objet InkDisp .
Clone Crée un objet InkDisp dupliqué.
CreateStroke Crée un trait à partir des points ou des données de paquet.
CreateStrokes Crée une collection InkStrokes pour cet objet InkDisp .
DeleteStroke Supprime un trait de l’objet InkDisp .
DeleteStrokes Supprime les traits de l’objet InkDisp .
Méthode ExtractStrokes Extrait les traits de l’objet InkDisp et retourne un nouvel objet InkDisp contenant les traits extraits.
Méthode ExtractWithRectangle Coupe ou copie les traits d’un objet de classe InkDisp existant et les colle dans un nouvel objet de classe InkDisp , en utilisant le rectangle connu pour déterminer les traits à extraire.
GetBoundingBox Récupère le cadre englobant de tous les traits dans l’objet InkDisp .
HitTestCircle Récupère la collection InkStrokes qui est entièrement à l’intérieur ou à l’intersection d’un cercle connu.
HitTestWithLasso Récupère les traits dans une zone de sélection de polylignes.
HitTestWithRectangle Récupère les traits qui sont contenus dans un rectangle spécifié.
Chargera Remplit un nouvel objet InkDisp avec des données binaires connues.
NearestPoint Récupère le IInkStrokeDisp dans l’objet InkDisp le plus proche d’un point connu, en fournissant éventuellement des informations supplémentaires.
Enregistrer Convertit l’encre dans un format spécifié et retourne les données binaires.

Propriétés

La classe InkDisp possède les propriétés suivantes.

Propriété Type d’accès Description
CustomStrokes
Lecture seule
Obtient la collection IInkCustomStrokes à rendre persistante avec l’encre.
Dirt
Lecture/écriture
Obtient ou définit la valeur qui indique si un objet InkDisp a été modifié depuis le dernier enregistrement de l’encre.
ExtendedProperties
Lecture seule
Obtient la collection de données définies par l’application.
Traits
Lecture seule
Obtient la collection InkStrokes contenue dans l’objet InkDisp .

Notes

Cet objet peut être instancié en appelant la méthode CoCreateInstance en C++.

Notes

la première instanciation de cet objet provoque également l’instanciation de GDI+. un effet secondaire est que si vous utilisez un seul objet ink dans une boucle et que vous le créez et le détruisez dans la boucle, vous risquez d’instancier GDI+. Cela peut entraîner une dégradation des performances dans votre application. Pour éviter cela, conservez une seule instance d’un objet Ink à tout moment pendant que votre application utilise de l’encre.

Un objet InkDisp est un conteneur de données de trait (point). Les données de trait, ou les points recueillis par le stylet, sont placés dans un objet InkDisp . La propriété Strokes contient les données de tous les traits de l’objet InkDisp .

L’objet InkCollector , l’objet InkOverlay et le contrôle InkPicture collectent les points de l’appareil d’entrée et les place dans un objet InkDisp . Ces objets agissent essentiellement comme la source qui distribue l’encre dans un ou plusieurs objets InkDisp différents, qui jouent le rôle de conteneurs qui contiennent l’encre distribuée.

L’espace d’encre est un espace de coordonnées virtuelles auquel les coordonnées du contexte de tablette sont mappées. Cet espace est fixe à un système de coordonnées HIMETRIC. Dans les coordonnées d’espace d’encre, un déplacement de 0 à 1 est égal à 1 unité HIMETRIC. Ce mappage facilite la mise en relation de plusieurs objets InkDisp .

L’objet InkRenderer gère les mappages entre l’encre et la fenêtre d’affichage.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Applications de bureau XP Édition Tablet PC [ uniquement]
Serveur minimal pris en charge
Aucun pris en charge
En-tête
Msinkaut. h (nécessite également Msinkaut _ i. c)
Bibliothèque
InkObj.dll

Voir aussi

Interface IInkStrokeDisp

Collection InkStrokes

Interface IInkTablet