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 |
|
| Bibliothèque |
|