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