Windows.UI.Input.Inking Namespace

Bietet Eingabe-, Verarbeitungs- und Verwaltungsunterstützung für Windows Ink-Apps. Dies umfasst u. a.:

• Zeichnen von Freihandstrichen.
• Erfassen von Strichen.
• Rendern von Strichen.
• Auswählen von Strichen.
• Striche werden gelöscht.
• Speichern und Laden von Strichen.
• Konvertieren von Strichen in Text über die Handschrifterkennung.
• Kopieren und Einfügen von Strichen aus der Zwischenablage.
• Treffertests (oder Strichziel).

Klassen

InkDrawingAttributes	Stellt Eigenschaften bereit, die der Zeichnung einer InkStroke zugeordnet sind.
InkDrawingAttributesPencilProperties	Stellt eine Reihe statischer InkDrawingAttributes-Eigenschaften zum Rendern eines Stiftstrichs auf einem InkCanvas bereit. Rufen Sie eine instance dieser Klasse ab, indem Sie InkDrawingAttributes.CreateForPencil aufrufen und auf InkDrawingAttributes.PencilProperties zugreifen.
InkInputConfiguration	Verwaltet, welche Typen sekundärer Eingaben vom InkPresenter-Objekt verarbeitet werden können.
InkInputProcessingConfiguration	Verwaltet, wie Eingaben vom InkPresenter-Objekt verarbeitet werden.
InkManager	Hinweis Für universelle Windows-Apps mit Extensible Application Markup Language (XAML) empfehlen wir die Verwendung von InkPresenter und dem InkCanvas-Steuerelement anstelle von InkManager. Verwaltet die Eingabe, Bearbeitung und Verarbeitung (einschließlich Handschrifterkennung) eines oder mehrerer InkStroke-Objekte .
InkModelerAttributes	Verwaltet, welche Typen von Freihandmodelliererattributen vom InkPresenter-Objekt verarbeitet werden können.
InkPoint	Stellt rohe Eingabedaten für einen einzelnen Punkt bereit, der beim Erstellen einer InkStroke verwendet wird.
InkPresenter	Stellt Eigenschaften, Methoden und Ereignisse zum Verwalten der Eingabe, Verarbeitung und Rendering von Freihandeingaben (standard und geändert) für ein InkCanvas-Steuerelement bereit.
InkPresenterProtractor	Stellt eine visuelle Schablone in Form eines Protractors zum Zeichnen von Bögen und Kurven dar, die als halbtransparente Überlagerung auf einem InkCanvas angezeigt wird. Die Schablone transformiert, wie ein Freihandstrich gerendert wird: Der Freihandstrich wird am Schablonenrand angeknipst, wenn sich die Stiftspitze innerhalb eines Abstandsschwellenwerts (Dachrinne) befindet. Es fungiert als Maske und verhindert das Zeichnen eines Freihandstrichs innerhalb des durch die Schablone verdeckten Bereichs. Der InkPresenterRuler kann sowohl programmgesteuert als auch vom Benutzer bearbeitet werden. Es skaliert und übersetzt mit dem InkCanvas.
InkPresenterRuler	Stellt eine visuelle Schablone in Form einer geraden Regel zum Zeichnen gerader Linien dar, die als halbtransparente Überlagerung auf einem InkCanvas angezeigt wird. Die Schablone transformiert, wie ein Freihandstrich gerendert wird: Der Freihandstrich wird am Schablonenrand angeknipst, wenn sich die Stiftspitze innerhalb eines Abstandsschwellenwerts (Dachrinne) befindet. Es fungiert als Maske und verhindert das Zeichnen eines Freihandstrichs innerhalb des durch die Schablone verdeckten Bereichs. Der InkPresenterRuler kann sowohl programmgesteuert als auch vom Benutzer bearbeitet werden. Es skaliert und übersetzt mit dem InkCanvas.
InkRecognitionResult	Stellt Eigenschaften und Methoden zum Verwalten von InkStroke-Handschrifterkennungsdaten bereit. Erkennungsergebnisse werden für jedes Wort erzeugt, das von einem InkRecognizer erkannt wird.
InkRecognizer	Verwaltet alle Aspekte der Handschrifterkennung.
InkRecognizerContainer	Stellt Eigenschaften und Methoden zum Verwalten eines oder mehrerer InkRecognizer-Objekte bereit, die für die Handschrifterkennung verwendet werden. InkRecognizerContainer ist NULL, wenn im System keine Erkennungs-Engine verfügbar ist.
InkStroke	Ein einzelner Freihandstrich, einschließlich der Parameter der Bézierkurve, die für das endgültige Rendering des Strichs verwendet werden.
InkStrokeBuilder	Erstellt Striche aus unformatierten Zeigereingaben. Hinweis Für universelle Windows-Apps mit Extensible Application Markup Language (XAML) empfehlen wir die Verwendung von InkPresenter und dem InkCanvas-Steuerelement anstelle von InkManager. Verwenden Sie CreateStrokeFromInkPoints und SetDefaultDrawingAttributes , um programmgesteuert Striche für einen InkPresenter zu erstellen.
InkStrokeContainer	Stellt Eigenschaften und Methoden zum Speichern und Verwalten der Auflistung von InkStroke-Objekten bereit, die vom InkPresenter gerendert werden. Änderungen, die an einem der Freihandstriche im Strichcontainer vorgenommen wurden, werden sofort auf der Zeichnungsoberfläche gerendert, die dem InkPresenter zugeordnet ist.
InkStrokeInput	Stellt Eigenschaften und Ereignisse für StrokeInput bereit, die einem InkPresenter-Objekt zugeordnet sind.
InkStrokeRenderingSegment	Ein einzelnes Segment eines vollständigen Freihandstrichs. Ein einzelnes Segment besteht aus einem Startpunkt, einem Endpunkt und zwei Bézier-Steuerungspunkten. Für eine Reihe von Segmenten, die einen Strich bilden, ist der letzte Punkt des vorherigen Segments jedoch der erste Punkt des aktuellen Segments. Dies bedeutet, dass nur der Endpunkt für jedes Segment erforderlich ist, um einen vollständigen Strich darzustellen. Jeder Strich ist ein Vektor von InkStrokeRenderingSegment-Objekten, wobei das erste Segment durch einen einzelnen Startpunkt und alle verbleibenden Segmente durch einen Endpunkt und zwei Bézier-Kontrollpunkte identifiziert werden.
InkStrokesCollectedEventArgs	Enthält Ereignisdaten für das StrokesCollected-Ereignis des InkPresenter,das einem InkCanvas-Steuerelement zugeordnet ist. Standardmäßig wird ein Freihandstrich in einem Hintergrundthread mit geringer Latenz verarbeitet und beim Zeichnen nass gerendert. Wenn der Strich abgeschlossen ist (Stift oder Finger angehoben oder maustaste losgelassen), wird der Strich im UI-Thread verarbeitet und trocken auf die InkCanvas-Ebene (oberhalb des Anwendungsinhalts) gerendert. Wenn der UI-Thread ausgelastet ist, werden möglicherweise mehrere Freihandstriche verarbeitet (gesammelt), wenn der Thread verfügbar wird. Dieses Verhalten kann überschrieben werden, indem die ActivateCustomDrying-Methode vor dem Laden von InkCanvas aufgerufen wird.
InkStrokesErasedEventArgs	Enthält Ereignisdaten für das StrokesErased-Ereignis des InkPresenter , das einem InkCanvas-Steuerelement zugeordnet ist. Standardmäßig werden Freihandstrichdaten und -rendering vollständig vom InkCanvas-Steuerelement verwaltet. Dieses Verhalten kann jedoch überschrieben werden, indem die ActivateCustomDrying-Methode vor dem Laden von InkCanvas aufgerufen wird.
InkSynchronizer	Verwaltet die Synchronisierung von Freihandeingaben und stellt Methoden zum Rendern im Direct2D-Gerätekontext Ihrer universellen Windows-App anstelle des Standardmäßigen InkCanvas-Steuerelements bereit. Dazu ist ein IInkD2DRenderer-Objekt erforderlich, um die Freihandeingabe zu verwalten (siehe Beispiel für komplexe Freihandeingaben). Standardmäßig werden Freihandeingaben in einem Hintergrundthread mit geringer Wartezeit verarbeitet und während des Zeichnens „nass“ gerendert. Wenn der Strich abgeschlossen ist (der Stift oder Finger wurde angehoben oder die Maustaste losgelassen), wird er im UI-Thread verarbeitet und auf der InkCanvas-Ebene „trocken“ gerendert (über dem Anwendungsinhalt, wo er die nasse Freihandeingabe ersetzt). Eine App erstellt durch Aufruf von ActivateCustomDrying (vor dem Laden des InkCanvas-Steuerelements) ein InkSynchronizer-Objekt, um zu definieren, wie ein letzter Strich trocken in einer SurfaceImageSource- oder VirtualSurfaceImageSource-Klasse gerendert wird. Beispielsweise kann ein letzter Strich gerastert und in den Anwendungsinhalt integriert werden, statt auf einer separaten InkCanvas-Ebene gerendert zu werden.
InkUnprocessedInput	Stellt Eigenschaften und Ereignisse für die benutzerdefinierte Verarbeitung von Freihanddaten aus einem InkCanvas-Steuerelement bereit. Die Daten werden nicht von InkPresenter verarbeitet. Verwenden Sie InkInputProcessingConfiguration , um die Daten zu identifizieren, die als UnprocessedInput übergeben werden sollen.
PenAndInkSettings	Bietet Zugriff auf Benutzereinstellungen im Zusammenhang mit dem Akzeptieren und Konvertieren von Freihandeingaben in Texteingaben in einem Textsteuerelement (wenn HandwritingView aktiviert ist).

Schnittstellen

IInkPointFactory	Definiert die Implementierung für einen Typ, der InkPoint-Objekte generiert, die beim Erstellen eines InkStroke verwendet werden.
IInkPresenterRulerFactory	Definiert die Implementierung für einen Typ, der InkPresenterRuler-Objekte generiert, die bei der Konstruktion eines InkPresenter verwendet werden.
IInkPresenterStencil	Stellt eine visuelle Schablone dar, die als halbtransparente Überlagerung auf einem InkCanvas angezeigt wird. Die Schablone transformiert, wie ein Freihandstrich gerendert wird: Der Freihandstrich wird am Schablonenrand angeknipst, wenn sich die Stiftspitze innerhalb eines Abstandsschwellenwerts (Dachrinne) befindet. Es fungiert als Maske und verhindert das Zeichnen eines Freihandstrichs innerhalb des durch die Schablone verdeckten Bereichs. Die Schablone kann sowohl programmgesteuert als auch vom Benutzer bearbeitet werden. Es skaliert und übersetzt mit dem InkCanvas.
IInkRecognizerContainer	Stellt mindestens ein InkRecognizer-Objekt dar.
IInkStrokeContainer	Stellt einen Manager für die Auflistung von InkStroke-Objekten dar, die vom InkPresenter gerendert werden. Änderungen, die an einem der Freihandstriche im Strichcontainer vorgenommen wurden, werden sofort auf der Zeichnungsoberfläche gerendert, die dem InkPresenter zugeordnet ist.

Enumerationen

HandwritingLineHeight	Gibt den verfügbaren Schreibraum an, wenn Freihand für die Texteingabe in einem Textsteuerelement verwendet wird (wenn HandwritingView aktiviert ist).
InkDrawingAttributesKind	Gibt den Typ von InkDrawingAttributes an, die dem InkStroke zugeordnet sind.
InkHighContrastAdjustment	Gibt an, wie das InkPresenter-Objekt eingaben (standard und geändert) aus dem zugeordneten InkCanvas-Steuerelement verarbeitet, wenn sich das System im Modus mit hohem Kontrast befindet.
InkInputProcessingMode	Gibt an, wie das InkPresenter-Objekt Eingaben des zugehörigen InkCanvas-Steuerelements interpretiert. Standardmäßig werden Eingaben als Standard-Freihand- oder Löschstriche behandelt, oder sie kann als UnprocessedInput zur benutzerdefinierten Verarbeitung an Ihre App übergeben werden.
InkInputRightDragAction	Gibt an, wie das InkPresenter-Objekt sekundäre Eingaben über eine Stiftlaufschaltfläche, eine Stiftradiererspitze, eine rechte Maustaste oder ähnliches verarbeitet. Standardmäßig wird diese sekundäre Eingabe als primäre Eingabe verarbeitet und als InkStroke gerendert (siehe Hinweise).
InkManipulationMode	Gibt die Modi der Freihandeingabe an.
InkPersistenceFormat	Gibt die Formate zum Speichern von Freihandeingaben an.
InkPresenterPredefinedConfiguration	Gibt das Freihandverhalten eines oder mehrerer Kontaktpunkte an. Wird mit SetPredefinedConfiguration verwendet.
InkPresenterStencilKind	Gibt den Typ der Schablone an, die auf einem InkCanvas angezeigt werden kann.
InkRecognitionTarget	Gibt an, welche Striche sie in die Handschrifterkennung einschließen möchten.
PenHandedness	Identifiziert die bevorzugte Schreibhand, wie vom Benutzer unter Einstellungen –> Geräte –> Stift & Windows Ink –> Wählen Sie aus, mit welcher Hand Sie schreiben.
PenTipShape	Gibt die Form des Stifttips an.

Weitere Informationen

• Zeichen- und Eingabestiftinteraktionen
• Erste Schritte: Freihandunterstützung in Ihrer UWP-App
• Freihandanalysebeispiel (Basic) (C#)
• Beispiel für die Freihandschreiberkennung (C#)
• Speichern und Laden von Freihandstrichen aus einer ISF-Datei (Ink Serialized Format)
• Speichern und Laden von Freihandstrichen aus der Zwischenablage
• Beispiel für Position und Ausrichtung der Freihandsymbolleiste (Basic)
• Freihandsymbolleistenposition und Orientierungsbeispiel (dynamisch)
• Malbuchbeispiel
• Familiennotizbeispiel
• Freihandbeispiel (JavaScript)
• Beispiel für einfache Freihandeingaben (C#/C++)
• Beispiel für komplexe Freihandeingaben (C++)
• Freihandanalysebeispiel