InkUnprocessedInput Klasse

  • Referenz

Definition

Namespace:
Windows.UI.Input.Inking
Bearbeiten

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.

public ref class InkUnprocessedInput sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class InkUnprocessedInput final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class InkUnprocessedInput
Public NotInheritable Class InkUnprocessedInput
Vererbung
Object Platform::Object IInspectable InkUnprocessedInput
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute

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)

Hinweise

Eingaben von verschiedenen Geräten (einschließlich Toucheingabe, Stift und Maus) werden empfangen, verarbeitet und als Zeigereingabe verwaltet. Benutzerinteraktionen, die auf einem dieser Geräte basieren, können ein PointerEntered-, PointerExited-, PointerReleased-, PointerPressed-, PointerMoved-, PointerLost- oder PointerHovered-Ereignis erzeugen. Weitere Informationen finden Sie unter Verarbeiten von Zeigereingaben.

Eigenschaften

InkPresenter

Ruft das Dem InkCanvas-Steuerelementzugeordnete InkPresenter-Objekt ab, das die InkStroke-Daten erfasst. InkPresenter verarbeitet die Eingabe nicht, stattdessen werden die Daten von der App zur benutzerdefinierten Verarbeitung übergeben.

Ereignisse

PointerEntered

Tritt auf, wenn ein Zeiger in den Bereich des Treffertests oder begrenzungsenden Bereichs eines InkCanvas-Steuerelements eintritt.
PointerExited

Tritt auf, wenn ein Zeiger den Bereich des Treffertests oder begrenzungsenden Bereichs eines InkCanvas-Steuerelements verlässt.
PointerHovered

Tritt auf, wenn ein Zeiger über, aber nicht unten oder in Kontakt mit dem Treffertest oder dem umgebenden Bereich eines InkCanvas-Steuerelements erkannt wird.
PointerLost

Tritt auf, wenn ein Zeiger nicht mehr im oder über dem Treffertestbereich eines InkCanvas-Steuerelements erkannt wird.

In der Regel geht ein Zeiger verloren, wenn sich der Kontakt außerhalb des InkCanvas-Steuerelements bewegt oder der Kontakt von einem anderen Element erfasst wird.
PointerMoved

Tritt auf, wenn sich ein Zeiger innerhalb des Treffertestbereichs oder des begrenzungsenden Bereichs eines InkCanvas-Steuerelements bewegt.
PointerPressed

Tritt auf, wenn ein Zeiger den Kontakt innerhalb des Treffertest- oder Begrenzungsbereichs eines InkCanvas-Steuerelements registriert. Dies kann der Fall sein, wenn eine Maustaste gedrückt wird oder die Digitalisiereroberfläche von einem Finger oder Stift berührt wird.
PointerReleased

Kann auftreten, wenn ein Zeiger, der einem PointerPressed-Ereignis zugeordnet ist, innerhalb des Treffertests oder begrenzungsbereichs eines InkCanvas-Steuerelements angehoben oder freigegeben wird.

PointerReleased wird nicht garantiert zusammen mit PointerPressed auftreten, da stattdessen PointerLost oder PointerExited auftreten können. Sie sollten alle Ereignisse behandeln, die PointerPressed abschließen können.

Einige Gründe, warum PointerReleased möglicherweise nicht auftritt, sind:

  • Unterschiede bei der Verarbeitung von Eingaben durch bestimmte Hardware
  • Programmgesteuerte Zeigererfassung aus einem anderen Zeiger
  • Benutzeraktionen, die die Beziehung des Anzeigebereichs ändern, z. B. Ändern der Auflösung oder Überwachungseinstellungen
  • Eingabeinteraktionen, z. B. ein Tablettstift, der dieselbe Oberfläche berührt wie eine vorherige Toucheingabeaktion

Gilt für:

Weitere Informationen