Condividi tramite


Windows.UI.Input.Inking Spazio dei nomi

Fornisce il supporto di input, elaborazione e gestione per le app Windows Ink. ad esempio:

  • Disegno di tratti penna.
  • Acquisizione di tratti.
  • Tratti di rendering.
  • Selezione di tratti.
  • Eliminazione di tratti.
  • Salvataggio e caricamento di tratti.
  • Conversione di tratti in testo tramite riconoscimento della grafia.
  • Copia e incollamento di tratti dagli Appunti.
  • Hit testing (o destinazione del tratto).

Classi

InkDrawingAttributes

Fornisce proprietà associate al disegno di un oggetto InkStroke.

InkDrawingAttributesPencilProperties

Fornisce un set di proprietà InkDrawingAttributes statiche per il rendering di un tratto di matita in un oggetto InkCanvas.

Ottenere un'istanza di questa classe chiamando InkDrawingAttributes.CreateForPencil e accedendo a InkDrawingAttributes.PencilProperties.

InkInputConfiguration

Gestisce i tipi di input secondari che possono essere elaborati dall'oggetto InkPresenter .

InkInputProcessingConfiguration

Gestisce il modo in cui l'input viene elaborato dall'oggetto InkPresenter .

InkManager

Nota

Per l'app di Windows universale con Extensible Application Markup Language (XAML), è consigliabile usare InkPresenter e il controllo InkCanvas anziché InkManager .

Gestisce l'input, la manipolazione e l'elaborazione (incluso il riconoscimento della grafia) di uno o più oggetti InkStroke .

InkModelerAttributes

Gestisce i tipi di attributi del modello penna che possono essere elaborati dall'oggetto InkPresenter .

InkPoint

Fornisce dati di input non elaborati per un singolo punto usato nella costruzione di un oggetto InkStroke.

InkPresenter

Fornisce proprietà, metodi ed eventi per la gestione dell'input, dell'elaborazione e del rendering dell'input penna (standard e modificato) per un controllo InkCanvas .

InkPresenterProtractor

Rappresenta uno stencil visivo, sotto forma di protrattore per il disegno di archi e curve, visualizzato come sovrapposizione semitrasparente su un oggetto InkCanvas.

Lo stencil trasforma il rendering di un tratto penna:

  • Blocca il tratto penna al bordo dello stencil se la punta della penna si trova all'interno di una soglia di distanza (gutter).
  • Funge da maschera e impedisce il disegno di un tratto penna all'interno dell'area oscurata dallo stencil.

InkPresenterRuler può essere modificato a livello di codice e dall'utente. Ridimensiona e traduce anche con InkCanvas.

InkPresenterRuler

Rappresenta uno stencil visivo, sotto forma di regola dritta per il disegno di linee dritte, visualizzate come sovrapposizione semitrasparente su un oggetto InkCanvas.

Lo stencil trasforma il rendering di un tratto penna:

  • Blocca il tratto penna al bordo dello stencil se la punta della penna si trova all'interno di una soglia di distanza (gutter).
  • Funge da maschera e impedisce il disegno di un tratto penna all'interno dell'area oscurata dallo stencil.

InkPresenterRuler può essere modificato a livello di codice e dall'utente. Ridimensiona e traduce anche con InkCanvas.

InkRecognitionResult

Fornisce proprietà e metodi per gestire i dati di riconoscimento della grafia inkStroke .

I risultati del riconoscimento vengono prodotti per ogni parola rilevata da un inkRecognizer.

InkRecognizer

Gestisce tutti gli aspetti del riconoscimento della grafia.

InkRecognizerContainer

Fornisce proprietà e metodi per gestire uno o più oggetti InkRecognizer usati per il riconoscimento della grafia.

InkRecognizerContainer è Null se un motore di riconoscimento non è disponibile nel sistema.

InkStroke

Un singolo tratto penna, inclusi i parametri della curva Bézier usati per il rendering finale del tratto.

InkStrokeBuilder

Compila i tratti dall'input del puntatore non elaborato.

Nota

Per l'app di Windows universale con Extensible Application Markup Language (XAML), è consigliabile usare InkPresenter e il controllo InkCanvas anziché InkManager.

Usare CreateStrokeFromInkPoints e SetDefaultDrawingAttributes per compilare i tratti a livello di codice per un oggetto InkPresenter.

InkStrokeContainer

Fornisce proprietà e metodi per archiviare e gestire la raccolta di oggetti InkStroke sottoposti a rendering da InkPresenter.

Le modifiche apportate a uno qualsiasi dei tratti penna nel contenitore del tratto vengono immediatamente restituite all'area di disegno associata a InkPresenter.

InkStrokeInput

Fornisce proprietà ed eventi per StrokeInput associato a un oggetto InkPresenter .

InkStrokeRenderingSegment

Un singolo segmento di un tratto di input penna completo.

Un singolo segmento è costituito da un punto iniziale, un punto finale e due punti di controllo Bezier. Tuttavia, per una serie di segmenti che costituiscono un tratto, l'ultimo punto del segmento precedente è il primo punto del segmento corrente. Ciò significa che è necessario che solo il punto finale per ogni segmento rappresenti un tratto completo.

Ogni tratto è un vettore di oggetti InkStrokeRenderingSegment con il primo segmento identificato da un singolo punto iniziale e tutti i segmenti rimanenti identificati da un punto finale e due punti di controllo Bezier.

InkStrokesCollectedEventArgs

Contiene dati di evento per l'evento StrokesCollecteddell'oggetto InkPresenter associato a un controllo InkCanvas .

Per impostazione predefinita, un tratto penna viene elaborato in un thread di sfondo a bassa latenza e viene eseguito il rendering di un elemento bagnato durante il disegno. Quando il tratto viene completato (penna o dito sollevato o pulsante del mouse rilasciato), il tratto viene elaborato sul thread dell'interfaccia utente e viene eseguito il rendering secco al livello InkCanvas (sopra il contenuto dell'applicazione). Se il thread dell'interfaccia utente è occupato, è possibile elaborare più tratti penna (raccolti) quando il thread diventa disponibile.

Questo comportamento può essere sottoposto a override chiamando il metodo ActivateCustomDrying prima di caricare InkCanvas.

InkStrokesErasedEventArgs

Contiene i dati degli eventi per l'evento StrokesEraseddell'oggetto InkPresenter associato a un controllo InkCanvas .

Per impostazione predefinita, i dati del tratto penna e il rendering sono gestiti interamente dal controllo InkCanvas . Tuttavia, questo comportamento può essere sottoposto a override chiamando il metodo ActivateCustomDrying prima di caricare InkCanvas.

InkSynchronizer

Gestisce la sincronizzazione dell'input penna e fornisce metodi per eseguirne il rendering nel contesto del dispositivo Direct2D dell'app di Windows universale, anziché il controllo InkCanvas predefinito. Ciò richiede un oggetto IInkD2DRenderer per gestire l'input penna (vedere l'esempio di input penna complesso).

Per impostazione predefinita, l'input penna viene elaborato in un thread in background a bassa latenza e durante il disegno del tratto ne viene eseguito il rendering "intermedio". Una volta completato il tratto (ovvero sollevata la penna/il dito o rilasciato il pulsante del mouse), il tratto viene elaborato nel thread dell'interfaccia utente e ne viene eseguito il rendering "definitivo" nel livello InkCanvas (sopra il contenuto dell'applicazione e in sostituzione dell'input penna intermedio).

Chiamando ActivateCustomDrying (prima che sia caricato il controllo InkCanvas), un'app crea un oggetto InkSynchronizer per personalizzare la modalità di esecuzione del rendering definitivo di un tratto input penna in un oggetto SurfaceImageSource o VirtualSurfaceImageSource. Ad esempio, un tratto input penna può essere rasterizzato e integrato nel contenuto dell'applicazione anziché come livello InkCanvas separato.

InkUnprocessedInput

Fornisce proprietà ed eventi per l'elaborazione personalizzata dei dati penna da un controllo InkCanvas . I dati non vengono elaborati da InkPresenter.

Usare InkInputProcessingConfiguration per identificare i dati da passare come UnprocessedInput.

PenAndInkSettings

Fornisce l'accesso alle impostazioni utente correlate all'accettazione e alla conversione dell'input penna in un controllo testo (quando HandwritingView è abilitato).

Interfacce

IInkPointFactory

Definisce l'implementazione per un tipo che genera oggetti InkPoint usati nella costruzione di un oggetto InkStroke.

IInkPresenterRulerFactory

Definisce l'implementazione per un tipo che genera oggetti InkPresenterRuler usati nella costruzione di un InkPresenter.

IInkPresenterStencil

Rappresenta uno stencil visivo, visualizzato come sovrapposizione semi-trasparente in un oggetto InkCanvas.

Lo stencil trasforma il rendering di un tratto penna:

  • Blocca il tratto penna al bordo dello stencil se la punta della penna si trova all'interno di una soglia di distanza (gutter).
  • Funge da maschera e impedisce il disegno di un tratto penna all'interno dell'area oscurata dallo stencil.

Lo stencil può essere modificato sia a livello di codice che dall'utente. Ridimensiona e traduce anche con InkCanvas.

IInkRecognizerContainer

Rappresenta uno o più oggetti InkRecognizer .

IInkStrokeContainer

Rappresenta un gestore per l'insieme di oggetti InkStroke sottoposti a rendering da InkPresenter.

Le modifiche apportate a uno qualsiasi dei tratti penna nel contenitore del tratto vengono immediatamente restituite all'area di disegno associata a InkPresenter.

Enumerazioni

HandwritingLineHeight

Specifica lo spazio di scrittura della scrittura disponibile quando si usa input penna per l'input di testo in un controllo di testo (quando è abilitato HandwritingView ).

InkDrawingAttributesKind

Specifica il tipo di InkDrawingAttributes associato a InkStroke.

InkHighContrastAdjustment

Specifica come l'oggetto InkPresenter gestisce l'input (standard e modificato) dal controllo InkCanvas associato quando il sistema è in modalità a contrasto elevato.

InkInputProcessingMode

Specifica il modo in cui l'oggetto InkPresenter interpreta l'input dal controllo InkCanvas associato.

Per impostazione predefinita, l'input viene gestito come tratti di input penna o cancellazione standard oppure può essere passato come UnprocessedInput all'app per l'elaborazione personalizzata.

InkInputRightDragAction

Specifica il modo in cui l'oggetto InkPresenter gestisce l'input secondario da un pulsante della barra della penna, una punta di cancellazione della penna, un pulsante destro del mouse o un elemento simile.

Per impostazione predefinita, questo input secondario viene elaborato come input primario e sottoposto a rendering come inkStroke (vedere le osservazioni).

InkManipulationMode

Specifica le modalità di input penna.

InkPersistenceFormat

Specifica i formati per il salvataggio dell'input penna.

InkPresenterPredefinedConfiguration

Specifica il comportamento di input penna di uno o più punti di contatto. Usato con SetPredefinedConfiguration.

InkPresenterStencilKind

Specifica il tipo di stencil che può essere visualizzato in un oggetto InkCanvas.

InkRecognitionTarget

Indica quali tratti si desidera includere nel riconoscimento della grafia.

PenHandedness

Identifica la mano di scrittura preferita, come specificato dall'utente in Impostazioni - Dispositivi> - Penna & Windows Ink ->> Scegliere la mano con cui scrivere.

PenTipShape

Identifica la forma della descrizione penna.

Vedi anche