InkManager Klasse

Definition

Namespace:

Windows.UI.Input.Inking

Hinweis

Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden.

Verwaltet die Eingabe, Bearbeitung und Verarbeitung (einschließlich der Handschrifterkennung) eines oder mehrerer InkStroke-Objekte .

public ref class InkManager sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class InkManager final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class InkManager

function InkManager()

Public NotInheritable Class InkManager

Vererbung

Object Platform::Object IInspectable InkManager

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

IInkRecognizerContainer IInkStrokeContainer

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

In diesem Beispiel wird gezeigt, wie Ein InkManager-Objekt erstellt wird.

var inkManager = new Windows.UI.Input.Inking.InkManager();

Die folgende Funktion veranschaulicht, wie Alle Freihandstriche auf einer Canvas ausgewählt werden, die Teil der Strichauflistung dieses InkManager (inkManager) sind.

function selectAll()
{
    inkManager.getStrokes().forEach(
        function (stroke) 
        {
            stroke.selected = 1;
        }
    );
}

Hinweise

Wenn keine Erkennung erforderlich ist, verwenden Sie anstelle eines InkManager-Objekts ein InkStrokeContainer-Objekt . Frühere Erkennungsergebnisse sind weiterhin über GetRecognitionResults verfügbar.

Wenn nur eine Erkennung und kein Speicher erforderlich ist, verwenden Sie einen InkRecognizerContainer anstelle eines InkManagers.

Hinweis

Diese Klasse ist nicht agil, was bedeutet, dass Sie das Threadingmodell und das Marshallingverhalten berücksichtigen müssen. Weitere Informationen finden Sie unter Threading and Marshaling (C++/CX) und Using Windows-Runtime objects in a multithreaded environment (.NET).

Konstruktoren

InkManager()

Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Erstellt ein neues InkManager-Objekt , das zum Verwalten von InkStroke-Objekten verwendet wird.

Eigenschaften

BoundingRect	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Ruft das umgebende Rechteck der InkStroke-Auflistung ab, die vom InkManager verwaltet wird.
Mode	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Ruft den Freihandeingabemodus ab oder legt diese fest.

Methoden

AddStroke(InkStroke)	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Fügt der auflistung, die vom InkManager verwaltet wird, ein oder mehrere InkStroke-Objekte hinzu.
CanPasteFromClipboard()	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Gibt an, ob Inhalte in der Zwischenablage der InkStroke-Auflistung hinzugefügt werden können, die vom InkManager verwaltet wird. Hinweis Der Inhalt der Zwischenablage muss im serialisierten Freihandformat (Ink Serialized Format, ISF) vorliegen.
CopySelectedToClipboard()	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Kopiert die ausgewählten InkStroke-Objekte (aus der vom InkManager verwalteten InkStroke-Auflistung) im ISF-Format (Ink Serialized Format) in die Zwischenablage.
DeleteSelected()	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Löscht die ausgewählten InkStroke-Objekte aus der Vom InkManager verwalteten InkStroke-Auflistung.
GetRecognitionResults()	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Ruft die Auflistung von Wörtern ab, die von der Handschrifterkennung zurückgegeben werden.
GetRecognizers()	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Ruft die Auflistung der installierten Handschrifterkennungen ab.
GetStrokes()	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Ruft alle Freihandstriche in der Auflistung ab, die vom InkManager verwaltet wird.
LoadAsync(IInputStream)	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Lädt asynchron alle InkStroke-Objekte aus dem angegebenen Stream in die InkStroke-Auflistung , die vom InkManager verwaltet wird. Freihanddaten werden als ISF-Metadaten (Ink Serialized Format) serialisiert und in eine GIF-Datei (Graphics Interchange Format) eingebettet.
MoveSelected(Point)	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Verschiebt die ausgewählten Striche. Alle betroffenen Striche werden erneut gerendert.
PasteFromClipboard(Point)	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Fügt den InkStroke-Inhalt aus der Zwischenablage der InkStroke-Auflistung hinzu, die vom InkManager verwaltet wird, und rendert die neuen Striche.
ProcessPointerDown(PointerPoint)	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Verarbeitet Informationen über die Position und Die Merkmale des Kontaktpunkts, wie Druck und Neigung, beim ersten Nach unten kontakt. Sie müssen diese Methode aufrufen, bevor Sie ProcessPointerUpdate und dann ProcessPointerUp aufrufen. Wichtig Diese Methode wird in Desktop-Apps nicht unterstützt.
ProcessPointerUp(PointerPoint)	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Verarbeitet Informationen über die Position und die Merkmale des Kontaktpunkts, wie Druck und Neigung, auf dem Aufwärtskontakt. Sie müssen diese Methode aufrufen, nachdem Sie ProcessPointerUpdate aufgerufen haben. Wichtig Diese Methode wird in Desktop-Apps nicht unterstützt.
ProcessPointerUpdate(PointerPoint)	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Verarbeitet Positions- und Zustandseigenschaften wie Druck und Neigung für den angegebenen Zeiger vom letzten Zeigerereignis bis hin zum aktuellen Zeigerereignis. Rufen Sie diese Methode nach ProcessPointerDown und vor ProcessPointerUp auf. Wichtig Diese Methode wird in Desktop-Apps nicht unterstützt.
RecognizeAsync(InkRecognitionTarget)	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Führt die Handschrifterkennung für ein oder mehrere InkStroke-Objekte aus .
RecognizeAsync(InkStrokeContainer, InkRecognitionTarget)	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Führt die Handschrifterkennung für ein oder mehrere InkStroke-Objekte aus .
SaveAsync(IOutputStream)	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Speichert asynchron alle InkStroke-Objekte in der InkStroke-Auflistung , die vom InkManager verwaltet wird, im angegebenen Stream. Freihanddaten werden als ISF-Metadaten (Ink Serialized Format) serialisiert und in eine GIF-Datei (Graphics Interchange Format) eingebettet.
SelectWithLine(Point, Point)	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Wählt alle vom neuen Strich überschneidenen Striche aus. Hinweis Das Flag Selected wird für alle anderen Striche in der Auflistung zurückgesetzt.
SelectWithPolyLine(IIterable<Point>)	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Wählt alle Striche aus, die vollständig in der Polylinie enthalten sind. Hinweis Das Flag Selected wird für alle anderen Striche in der Auflistung zurückgesetzt. .
SetDefaultDrawingAttributes(InkDrawingAttributes)	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Legt die Standard-InkDrawingAttributes für alle neuen InkStroke-Objekte fest, die der vom InkManager verwalteten InkStroke-Auflistung hinzugefügt werden. SetDefaultDrawingAttributes wirkt sich nicht auf den aktuellen Strich oder vorhandene Striche aus.
SetDefaultRecognizer(InkRecognizer)	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Legt den Standardmäßigen InkRecognizer fest, der für die Handschrifterkennung verwendet wird.
UpdateRecognitionResults(IVectorView<InkRecognitionResult>)	Hinweis Für universelle Windows-Apps mit XAML (Extensible Application Markup Language) wird empfohlen , InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden. Updates die Sammlung potenzieller Textüberstimmungen aus der Handschrifterkennung.

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