Windows.UI.Input.Inking Espacio de nombres

Proporciona compatibilidad de entrada, procesamiento y administración para Windows Ink aplicaciones. Esto incluye:

  • Dibujar trazos de lápiz.
  • Captura de trazos.
  • Representar trazos.
  • Selección de trazos.
  • Eliminar trazos.
  • Guardar y cargar trazos.
  • Convertir trazos en texto mediante el reconocimiento de escritura a mano.
  • Copiar y pegar trazos desde el Portapapeles.
  • Pruebas de posicionamiento (o destino de trazo).

Clases

InkDrawingAttributes

Proporciona propiedades asociadas al dibujo de inkStroke.

InkDrawingAttributesPencilProperties

Proporciona un conjunto de propiedades inkDrawingAttributes estáticas para representar un trazo de lápiz en inkCanvas.

Obtenga una instancia de esta clase llamando a InkDrawingAttributes.CreateForPencil y accediendo a InkDrawingAttributes.PencilProperties.

InkInputConfiguration

Administra qué tipos de entrada secundaria se pueden procesar mediante el objeto InkPresenter .

InkInputProcessingConfiguration

Administra cómo procesa la entrada el objeto InkPresenter .

InkManager

Nota:

Para la aplicación universal de Windows con lenguaje de marcado de aplicación extensible (XAML), se recomienda usar InkPresenter y el control InkCanvas en lugar de InkManager.

Administra la entrada, manipulación y procesamiento (incluido el reconocimiento de escritura a mano) de uno o varios objetos InkStroke .

InkModelerAttributes

Administra qué tipos de atributos del modelador de entrada de lápiz se pueden procesar mediante el objeto InkPresenter .

InkPoint

Proporciona datos de entrada sin procesar para un único punto utilizado en la construcción de inkStroke.

InkPresenter

Proporciona propiedades, métodos y eventos para administrar la entrada, el procesamiento y la representación de entradas de lápiz (estándar y modificadas) para un control InkCanvas .

InkPresenterProtractor

Representa una galería de símbolos visuales, en forma de un protractor para dibujar arcos y curvas, que se muestran como una superposición semitransparente en un InkCanvas.

La galería de símbolos transforma cómo se representa un trazo de lápiz:

  • Ajusta el trazo de lápiz al borde de la galería de símbolos si la punta del lápiz está dentro de un umbral de distancia (canaleta).
  • Actúa como una máscara y evita el dibujo de un trazo de lápiz dentro del área oculta por la galería de símbolos.

InkPresenterRuler puede ser manipulado mediante programación y por el usuario. También escala y traduce con InkCanvas.

InkPresenterRuler

Representa una galería de símbolos visuales, en forma de regla recta para dibujar líneas rectas, mostradas como una superposición semitransparente en un InkCanvas.

La galería de símbolos transforma cómo se representa un trazo de lápiz:

  • Ajusta el trazo de lápiz al borde de la galería de símbolos si la punta del lápiz está dentro de un umbral de distancia (canaleta).
  • Actúa como una máscara y evita el dibujo de un trazo de lápiz dentro del área oculta por la galería de símbolos.

InkPresenterRuler puede ser manipulado mediante programación y por el usuario. También escala y traduce con InkCanvas.

InkRecognitionResult

Proporciona propiedades y métodos para administrar los datos de reconocimiento de escritura a mano de InkStroke .

Los resultados del reconocimiento se generan para cada palabra detectada por un InkRecognizer.

InkRecognizer

Administra todos los aspectos del reconocimiento de escritura a mano.

InkRecognizerContainer

Proporciona propiedades y métodos para administrar uno o varios objetos InkRecognizer usados para el reconocimiento de escritura a mano.

InkRecognizerContainer es null si un motor de reconocimiento no está disponible en el sistema.

InkStroke

Un único trazo de lápiz, incluidos los parámetros de curva Bézier utilizados para la representación final del trazo.

InkStrokeBuilder

Crea trazos a partir de la entrada de puntero sin procesar.

Nota:

Para la aplicación universal de Windows con lenguaje de marcado de aplicación extensible (XAML), se recomienda usar InkPresenter y el control InkCanvas en lugar de InkManager.

Use CreateStrokeFromInkPoints y SetDefaultDrawingAttributes para compilar trazos mediante programación para inkPresenter.

InkStrokeContainer

Proporciona propiedades y métodos para almacenar y administrar la colección de objetos InkStroke representados por InkPresenter.

Las modificaciones realizadas en cualquiera de los trazos de lápiz del contenedor de trazos se representan inmediatamente en la superficie de dibujo asociada a InkPresenter.

InkStrokeInput

Proporciona propiedades y eventos para StrokeInput asociado a un objeto InkPresenter .

InkStrokeRenderingSegment

Un único segmento de un trazo de lápiz completo.

Un único segmento consta de un punto inicial, un punto final y dos puntos de control Bezier. Sin embargo, para una serie de segmentos que componen un trazo, el último punto del segmento anterior es el primer punto del segmento actual. Esto significa que solo se requiere el punto final de cada segmento para representar un trazo completo.

Cada trazo es un vector de objetos InkStrokeRenderingSegment con el primer segmento identificado por un único punto inicial y todos los segmentos restantes identificados por un punto final y dos puntos de control Bezier.

InkStrokesCollectedEventArgs

Contiene datos de eventos para el evento StrokesCollected del inkPresenter asociado a un control InkCanvas .

De forma predeterminada, un trazo de lápiz se procesa en un subproceso de fondo de baja latencia y se representa húmedo a medida que se dibuja. Cuando se completa el trazo (lápiz o dedo quitado o botón del mouse), el trazo se procesa en el subproceso de la interfaz de usuario y se representa en seco en la capa InkCanvas (encima del contenido de la aplicación). Si el subproceso de la interfaz de usuario está ocupado, es posible que se procese más de un trazo de lápiz (recopilado) cuando el subproceso esté disponible.

Este comportamiento se puede invalidar llamando al método ActivateCustomDrying antes de cargar InkCanvas.

InkStrokesErasedEventArgs

Contiene datos de eventos para el evento StrokesErased del inkPresenter asociado a un control InkCanvas .

De forma predeterminada, el control InkCanvas administra completamente los datos y la representación de trazos de lápiz. Sin embargo, este comportamiento se puede invalidar llamando al método ActivateCustomDrying antes de cargar InkCanvas.

InkSynchronizer

Administra la sincronización de la entrada de lápiz y proporciona métodos para representarla en el contexto del dispositivo Direct2D de la aplicación universal de Windows, en lugar del control InkCanvas predeterminado. Esto requiere un objeto IInkD2DRenderer para administrar la entrada de lápiz (consulte el ejemplo de entrada de lápiz compleja).

De manera predeterminada, la entrada de lápiz se procesa en un subproceso en segundo plano de baja latencia y se representa como "húmeda" mientras se dibuja. Cuando se completa el trazo (se levanta el lápiz o el dedo o se libera el botón del mouse), el trazo se procesa en el subproceso de la interfaz de usuario y se representa como "seco" en la capa de InkCanvas (lo verás sobre el contenido de la aplicación y reemplazando la entrada de lápiz húmeda).

Al llamar a ActivateCustomDrying (antes de cargar InkCanvas), una aplicación crea un objeto InkSynchronizer para personalizar la representación de un trazo de lápiz seco en la clase SurfaceImageSource o VirtualSurfaceImageSource. Por ejemplo, un trazo de lápiz se puede rasterizar e integrar en el contenido de la aplicación, en lugar de hacerlo como una capa de InkCanvas diferente.

InkUnprocessedInput

Proporciona propiedades y eventos para el procesamiento personalizado de datos de entrada de lápiz desde un control InkCanvas . InkPresenter no procesa los datos.

Use InkInputProcessingConfiguration para identificar los datos que se van a pasar como UnprocessedInput.

PenAndInkSettings

Proporciona acceso a la configuración del usuario relacionada con la aceptación y conversión de entrada de lápiz a entrada de texto en un control de texto (cuando handwritingView está habilitado).

Interfaces

IInkPointFactory

Define la implementación de un tipo que genera objetos InkPoint usados en la construcción de inkStroke.

IInkPresenterRulerFactory

Define la implementación de un tipo que genera objetos InkPresenterRuler usados en la construcción de inkPresenter.

IInkPresenterStencil

Representa una galería de símbolos visuales, que se muestra como una superposición semitransparente en inkCanvas.

La galería de símbolos transforma cómo se representa un trazo de lápiz:

  • Ajusta el trazo de lápiz al borde de la galería de símbolos si la punta del lápiz está dentro de un umbral de distancia (canaleta).
  • Actúa como una máscara y evita el dibujo de un trazo de lápiz dentro del área oculta por la galería de símbolos.

La galería de símbolos se puede manipular mediante programación y por el usuario. También escala y traduce con InkCanvas.

IInkRecognizerContainer

Representa uno o varios objetos InkRecognizer .

IInkStrokeContainer

Representa un administrador para la colección de objetos InkStroke representados por InkPresenter.

Las modificaciones realizadas en cualquiera de los trazos de lápiz del contenedor de trazos se representan inmediatamente en la superficie de dibujo asociada a InkPresenter.

Enumeraciones

HandwritingLineHeight

Especifica el espacio de escritura a mano disponible cuando se usa la entrada de lápiz para la entrada de texto en un control de texto (cuando handwritingView está habilitado).

InkDrawingAttributesKind

Especifica el tipo de InkDrawingAttributes asociado a InkStroke.

InkHighContrastAdjustment

Especifica cómo el objeto InkPresenter controla la entrada (estándar y modificada) del control InkCanvas asociado cuando el sistema está en modo de contraste alto.

InkInputProcessingMode

Especifica cómo el objeto InkPresenter interpreta la entrada de su control InkCanvas asociado.

De forma predeterminada, la entrada se controla como trazos de lápiz o borrado estándar, o se puede pasar como UnprocessedInput a la aplicación para su procesamiento personalizado.

InkInputRightDragAction

Especifica cómo el objeto InkPresenter controla la entrada secundaria desde un botón de barril de lápiz, punta del borrador de lápiz, botón derecho del mouse o similar.

De forma predeterminada, esta entrada secundaria se procesa como entrada principal y se representa como inkStroke (vea comentarios).

InkManipulationMode

Especifica los modos de entrada de lápiz.

InkPersistenceFormat

Especifica los formatos para guardar la entrada de lápiz.

InkPresenterPredefinedConfiguration

Especifica el comportamiento de entrada manuscrita de uno o varios puntos de contacto. Se usa con SetPredefinedConfiguration.

InkPresenterStencilKind

Especifica el tipo de galería de símbolos que se puede mostrar en inkCanvas.

InkRecognitionTarget

Indica qué trazos desea incluir en el reconocimiento de escritura a mano.

PenHandedness

Identifica la mano de escritura preferida, tal como especifica el usuario en Configuración -> Dispositivos -> Lápiz & Windows Ink -> Elegir la mano con la que escribir.

PenTipShape

Identifica la forma de la información sobre lápiz.

Consulte también