Partager via


Classe InkDisp

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 l’objet IDataObject peut être converti en objet InkDisp .
Clip Supprime des parties d’un trait ou d’une collection de traits qui se trouvent en dehors d’un rectangle.
Presse-papiersCopy Copie la collection InkStrokes dans le Presse-papiers.
Presse-papiersCopyWithRectangle Copie les objets IInkStrokeDisp contenus dans le rectangle connu dans le Presse-papiers.
Presse-papiersPaste Copie l’objet IDataObject du Presse-papiers vers l’objet InkDisp .
Clone Crée un objet InkDisp en double.
CreateStroke Crée un trait à partir de points ou de données de paquet.
Créer des séquences 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 .
ExtractStrokes, méthode Extrait les traits de l’objet InkDisp et retourne un nouvel objet InkDisp contenant les traits extraits.
ExtractWithRectangle, méthode Coupe ou copie les traits d’un objet de classe InkDisp existant et les colle dans un nouvel objet De classe InkDisp , à l’aide du rectangle connu pour déterminer les traits à extraire.
GetBoundingBox Récupère le cadre englobant de tous les traits de l’objet InkDisp .
HitTestCircle Récupère la collection InkStrokes qui se trouve complètement à l’intérieur ou qui est croisée par un cercle connu.
HitTestWithLasso Récupère les traits dans une zone de sélection polyligne.
HitTestWithRectangle Récupère les traits contenus dans un rectangle spécifié.
Charge Remplit un nouvel objet InkDisp avec des données binaires connues.
NearestPoint Récupère l’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 ces propriétés.

Propriété Type d’accès Description
CustomStrokes
Lecture seule
Obtient la collection IInkCustomStrokes à conserver avec l’encre.
Sale
Lecture/écriture
Obtient ou définit la valeur qui indique si un objet InkDisp a été modifié depuis la dernière fois que l’encre a été enregistrée.
ExtendedProperties
Lecture seule
Obtient la collection de données définies par l’application.
Coups
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 entraîne également l’instanciation de GDI+ . Un effet secondaire est que si vous utilisez un seul objet d’encre dans une boucle et que vous le créez et le détruisez dans la boucle, vous allez provoquer l’instanciation de GDI+ à plusieurs reprises. Cela peut entraîner une dégradation des performances dans votre application. Pour éviter cela, conservez une seule instance d’un objet manuscrit à tout moment pendant que votre application utilise l’encre.

Un objet InkDisp est un conteneur de données de trait (point). Les données de trait, ou les points collectés 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 des points à partir du périphérique d’entrée et les placent dans un objet InkDisp. Ces objets agissent essentiellement comme la source qui distribue l’encre dans un ou plusieurs objets InkDisp différents, qui agissent comme des conteneurs qui contiennent l’encre distribuée.

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

L’objet InkRenderer gère les mappages entre l’entrée manuscrite et la fenêtre d’affichage.

Spécifications

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
En-tête
Msinkaut.h (nécessite également Msinkaut_i.c)
Bibliothèque
InkObj.dll

Voir aussi

IInkStrokeDisp, interface

InkStrokes Collection

IInkTablet, interface