Freigeben über


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