Windows.UI.Input.Inking Spazio dei nomi
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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:
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:
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:
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
- Interazioni tramite penna e stilo
- Introduzione: Supporto dell'input penna nell'app UWP
- Esempio di analisi penna (base) (C#)
- Esempio di riconoscimento della grafia penna (C#)
- Salvare e caricare i tratti penna da un file ISF (Ink Serialized Format)
- Salvare e caricare i tratti penna dagli Appunti
- Esempio di posizione e orientamento della barra degli strumenti penna (base)
- Esempio di posizione e orientamento della barra degli strumenti penna (dinamico)
- Esempio di app Coloring Book
- Esempio FamilyNotes
- Esempio di input penna (JavaScript)
- Esempio di input penna semplice (C#/C++)
- Esempio di input penna complesso (C++)
- Esempio di analisi dell'input penna