Partager via


Windows.UI.Input.Inking Espace de noms

Fournit une prise en charge de l’entrée, du traitement et de la gestion des applications Windows Ink. notamment :

  • Traits d’encre de dessin.
  • Capture des traits.
  • Traits de rendu.
  • Sélection de traits.
  • Suppression de traits.
  • Enregistrement et chargement des traits.
  • Conversion des traits en texte via la reconnaissance de l’écriture manuscrite.
  • Copier et coller des traits à partir du Presse-papiers.
  • Test de positionnement (ou ciblage de trait).

Classes

InkDrawingAttributes

Fournit les propriétés associées au dessin d’un InkStroke.

InkDrawingAttributesPencilProperties

Fournit un ensemble de propriétés InkDrawingAttributes statiques pour le rendu d’un trait de crayon sur un InkCanvas.

Obtenez une instance de cette classe en appelant InkDrawingAttributes.CreateForPencil et en accédant à InkDrawingAttributes.PencilProperties.

InkInputConfiguration

Gère les types d’entrée secondaire qui peuvent être traités par l’objet InkPresenter .

InkInputProcessingConfiguration

Gère la façon dont l’entrée est traitée par l’objet InkPresenter .

InkManager

Notes

Pour l’application Windows universelle utilisant le langage XAML (Extensible Application Markup Language), nous vous recommandons d’utiliser InkPresenter et le contrôle InkCanvas au lieu d’InkManager.

Gère l’entrée, la manipulation et le traitement (y compris la reconnaissance de l’écriture manuscrite) d’un ou de plusieurs objets InkStroke .

InkModelerAttributes

Gère les types d’attributs du modélisateur d’encre qui peuvent être traités par l’objet InkPresenter .

InkPoint

Fournit des données d’entrée brutes pour un point unique utilisé dans la construction d’un InkStroke.

InkPresenter

Fournit des propriétés, des méthodes et des événements pour gérer l’entrée, le traitement et le rendu de l’entrée manuscrite (standard et modifiée) pour un contrôle InkCanvas .

InkPresenterProtractor

Représente un gabarit visuel, sous la forme d’un traceur pour dessiner des arcs et des courbes, affiché sous la forme d’une superposition semi-transparente sur un InkCanvas.

Le gabarit transforme le rendu d’un trait d’encre :

  • Il aligne le trait d’encre sur le bord du gabarit si l’extrémité du stylet se trouve dans un seuil de distance (gouttière).
  • Il agit comme un masque et empêche le dessin d’un trait d’encre dans la zone masquée par le gabarit.

InkPresenterRuler peut être manipulé à la fois par programme et par l’utilisateur. Il met également à l’échelle et traduit avec InkCanvas.

InkPresenterRuler

Représente un gabarit visuel, sous la forme d’une règle droite pour dessiner des lignes droites, affiché sous la forme d’une superposition semi-transparente sur un InkCanvas.

Le gabarit transforme le rendu d’un trait d’encre :

  • Il aligne le trait d’encre sur le bord du gabarit si l’extrémité du stylet se trouve dans un seuil de distance (gouttière).
  • Il agit comme un masque et empêche le dessin d’un trait d’encre dans la zone masquée par le gabarit.

InkPresenterRuler peut être manipulé à la fois par programme et par l’utilisateur. Il met également à l’échelle et traduit avec InkCanvas.

InkRecognitionResult

Fournit des propriétés et des méthodes pour gérer les données de reconnaissance d’écriture manuscrite InkStroke .

Les résultats de reconnaissance sont générés pour chaque mot détecté par un InkRecognizer.

InkRecognizer

Gère tous les aspects de la reconnaissance de l’écriture manuscrite.

InkRecognizerContainer

Fournit des propriétés et des méthodes pour gérer un ou plusieurs objets InkRecognizer utilisés pour la reconnaissance de l’écriture manuscrite.

InkRecognizerContainer a la valeur Null si un moteur de reconnaissance n’est pas disponible sur le système.

InkStroke

Un seul trait d’encre, y compris les paramètres de courbe de Bézier utilisés pour le rendu final du trait.

InkStrokeBuilder

Génère des traits à partir d’une entrée de pointeur brute.

Notes

Pour l’application Windows universelle utilisant le langage XAML (Extensible Application Markup Language), nous vous recommandons d’utiliser InkPresenter et le contrôle InkCanvas au lieu d’InkManager.

Utilisez CreateStrokeFromInkPoints et SetDefaultDrawingAttributes pour générer par programmation des traits pour un InkPresenter.

InkStrokeContainer

Fournit des propriétés et des méthodes pour stocker et gérer la collection d’objets InkStroke rendus par InkPresenter.

Les modifications apportées à l’un des traits d’encre dans le conteneur de traits sont immédiatement affichées sur la surface de dessin associée à InkPresenter.

InkStrokeInput

Fournit des propriétés et des événements pour StrokeInput associés à un objet InkPresenter .

InkStrokeRenderingSegment

Segment unique d’un trait d’encre complet.

Un seul segment se compose d’un point de départ, d’un point de fin et de deux points de contrôle béziers. Toutefois, pour une série de segments qui composent un trait, le dernier point du segment précédent est le premier point du segment actuel. Cela signifie que seul le point de fin de chaque segment est requis pour représenter un trait complet.

Chaque trait est un vecteur d’objets InkStrokeRenderingSegment avec le premier segment identifié par un point de départ unique et tous les segments restants identifiés par un point de fin et deux points de contrôle Bézier.

InkStrokesCollectedEventArgs

Contient des données d’événement pour l’événement StrokesCollected du inkPresenter associé à un contrôle InkCanvas .

Par défaut, un trait d’encre est traité sur un thread d’arrière-plan à faible latence et rendu humide au fur et à mesure qu’il est dessiné. Une fois le trait terminé (stylet ou doigt levé, ou bouton de la souris relâché), le trait est traité sur le thread d’interface utilisateur et rendu sec au calque InkCanvas (au-dessus du contenu de l’application). Si le thread d’interface utilisateur est occupé, plusieurs traits d’encre peuvent être traités (collectés) lorsque le thread devient disponible.

Ce comportement peut être remplacé en appelant la méthode ActivateCustomDrying avant de charger inkCanvas.

InkStrokesErasedEventArgs

Contient des données d’événement pour l’événement StrokesErased du inkPresenter associé à un contrôle InkCanvas .

Par défaut, les données de trait d’encre et le rendu sont entièrement gérés par le contrôle InkCanvas . Toutefois, ce comportement peut être remplacé en appelant la méthode ActivateCustomDrying avant de charger InkCanvas.

InkSynchronizer

Gère la synchronisation de l’entrée manuscrite et fournit des méthodes de rendu dans le contexte d’appareil Direct2D de votre application Windows universelle, au lieu du contrôle InkCanvas par défaut. Cela nécessite un objet IInkD2DRenderer pour gérer l’entrée manuscrite (voir l’exemple d’encre complexe).

Par défaut, l’entrée manuscrite est traitée sur un thread d’arrière-plan de faible latence et restituée « humide » comme elle est dessinée. Lorsque le trait est terminé (stylet ou doigt relevé, ou bouton de la souris relâché), le trait est traité sur le thread de l’interface utilisateur et restitué « sec » à la couche InkCanvas (au-dessus du contenu de l’application et en remplaçant l’encre humide).

En appelant ActivateCustomDrying (avant le chargement de InkCanvas), une application crée un objet InkSynchronizer pour personnaliser la manière dont un trait d’encre est restitué sec à un élément SurfaceImageSource ou VirtualSurfaceImageSource. Par exemple, un trait d’encre pourrait être rastérisé et intégré au contenu d’application plutôt que d’être intégré sous forme de couche InkCanvas distincte.

InkUnprocessedInput

Fournit des propriétés et des événements pour le traitement personnalisé des données manuscrites à partir d’un contrôle InkCanvas . Les données ne sont pas traitées par InkPresenter.

Utilisez InkInputProcessingConfiguration pour identifier les données à transmettre en tant que UnprocessedInput.

PenAndInkSettings

Permet d’accéder aux paramètres utilisateur liés à l’acceptation et à la conversion de l’entrée manuscrite en entrée de texte dans un contrôle de texte (lorsque HandwritingView est activé).

Interfaces

IInkPointFactory

Définit l’implémentation d’un type qui génère des objets InkPoint utilisés dans la construction d’un InkStroke.

IInkPresenterRulerFactory

Définit l’implémentation d’un type qui génère des objets InkPresenterRuler utilisés dans la construction d’un InkPresenter.

IInkPresenterStencil

Représente un gabarit visuel, affiché sous la forme d’une superposition semi-transparente sur un InkCanvas.

Le gabarit transforme le rendu d’un trait d’encre :

  • Il aligne le trait d’encre sur le bord du gabarit si l’extrémité du stylet se trouve dans un seuil de distance (gouttière).
  • Il agit comme un masque et empêche le dessin d’un trait d’encre dans la zone masquée par le gabarit.

Le gabarit peut être manipulé à la fois par programmation et par l’utilisateur. Il met également à l’échelle et traduit avec InkCanvas.

IInkRecognizerContainer

Représente un ou plusieurs objets InkRecognizer .

IInkStrokeContainer

Représente un gestionnaire pour la collection d’objets InkStroke rendus par InkPresenter.

Les modifications apportées à l’un des traits d’encre dans le conteneur de traits sont immédiatement affichées sur la surface de dessin associée à InkPresenter.

Énumérations

HandwritingLineHeight

Spécifie l’espace d’écriture manuscrite disponible lors de l’utilisation de l’entrée manuscrite pour la saisie de texte dans un contrôle de texte (lorsque HandwritingView est activé).

InkDrawingAttributesKind

Spécifie le type d’attributs InkDrawingAttributes associés à InkStroke.

InkHighContrastAdjustment

Spécifie la façon dont l’objet InkPresenter gère l’entrée (standard et modifiée) à partir du contrôle InkCanvas associé lorsque le système est en mode à contraste élevé.

InkInputProcessingMode

Spécifie la façon dont l’objet InkPresenter interprète l’entrée de son contrôle InkCanvas associé.

Par défaut, l’entrée est gérée en tant que traits d’encre ou d’effacement standard, ou elle peut être passée en tant que UnprocessedInput à votre application pour un traitement personnalisé.

InkInputRightDragAction

Spécifie la façon dont l’objet InkPresenter gère l’entrée secondaire à partir d’un bouton de canon de stylet, d’un embout de gomme de stylet, d’un bouton droit de la souris ou similaire.

Par défaut, cette entrée secondaire est traitée en tant qu’entrée primaire et rendue en tant que InkStroke (voir les remarques).

InkManipulationMode

Spécifie les modes d’entrée manuscrite.

InkPersistenceFormat

Spécifie les formats d’enregistrement de l’entrée manuscrite.

InkPresenterPredefinedConfiguration

Spécifie le comportement d’entrée manuscrite d’un ou plusieurs points de contact. Utilisé avec SetPredefinedConfiguration.

InkPresenterStencilKind

Spécifie le type de gabarit qui peut être affiché sur un InkCanvas.

InkRecognitionTarget

Indique les traits que vous souhaitez inclure dans la reconnaissance de l’écriture manuscrite.

PenHandedness

Identifie la main d’écriture préférée, comme spécifié par l’utilisateur dans Paramètres -> Appareils -> Stylet & Windows Ink -> Choisissez la main avec laquelle vous écrivez.

PenTipShape

Identifie la forme de l’info-bulle.

Voir aussi