PointerPointProperties-Klasse
TOC
Inhaltsverzeichnis reduzieren
Inhaltsverzeichnis erweitern

PointerPointProperties Class

Erstellt erweiterte Eigenschaften für ein PointerPoint-Objekt.

In den meisten Fällen wird empfohlen, Zeigerinformationen durch die Zeigerereignishandler des ausgewählten Windows 8-Language Frameworks abzurufen (Windows Store-Apps mit JavaScript, Windows Store-Apps mit C++, C# oder Visual Basic sowie Windows Store-Apps mit DirectX und C++).

Wenn das Ereignisargument nicht die Zeigerdetails verfügbar macht, die von der Anwendung benötigt werden, ist mit den Methoden getCurrentPoint und getIntermediatePoints oder den Eigenschaften currentPoint und intermediatePoints kein Zugriff auf die erweiterten Zeigerdaten des Ereignisarguments möglich. Es empfiehlt sich, die Methoden getCurrentPoint und getIntermediatePoints zu verwenden, da Sie den Kontext für die Zeigerdaten angeben können.

Die statischen Methoden PointerPoint, GetCurrentPoint und GetIntermediatePoints verwenden immer den Kontext der App.

Syntax


var pointerPointProperties = Windows.UI.Input.PointerPoint.properties;

Attribute

[MarshalingBehavior(None)]
[Version(0x06020000)]

Member

PointerPointPropertiesKlasse hat diese Membertypen:

Methoden

The PointerPointProperties Klasse hat diese Methoden. Mit C#, Visual Basic und C++ erbt es auch Methoden aus Object Klasse.

MethodeBeschreibung
GetUsageValue Gets the Human Interface Device (HID) usage value of the raw input.
HasUsage Gets a value that indicates whether the input data from the pointer device contains the specified Human Interface Device (HID) usage information.

 

Eigenschaften

Der PointerPointPropertiesKlasse hat diese Eigenschaften.

EigenschaftZugriffstypBeschreibung

ContactRect

SchreibgeschütztGets the bounding rectangle of the contact area (typically from touch input).

ContactRectRaw

SchreibgeschütztGets the bounding rectangle of the raw input (typically from touch input).

IsBarrelButtonPressed

SchreibgeschütztGets a value that indicates whether the barrel button of the pen/stylus device is pressed.

IsCanceled

SchreibgeschütztGets a value that indicates whether the input was canceled by the pointer device.

IsEraser

SchreibgeschütztGets a value that indicates whether the input is from a digitizer eraser.

IsHorizontalMouseWheel

SchreibgeschütztGets a value that indicates whether the input is from a mouse tilt wheel.

IsInRange

SchreibgeschütztGets a value that indicates whether the pointer device is within detection range of a sensor or digitizer.

IsInverted

SchreibgeschütztGets a value that indicates whether the digitizer pen is inverted.

IsLeftButtonPressed

SchreibgeschütztGets a value that indicates whether the input is from the left button of a mouse or other input method.

IsMiddleButtonPressed

SchreibgeschütztGets a value that indicates whether the input is from the middle button of a mouse or other input method.

IsPrimary

SchreibgeschütztGets a value that indicates whether the input is from the primary pointer when multiple pointers are registered.

IsRightButtonPressed

SchreibgeschütztGets a value that indicates whether the input is from the right button of a mouse or other input method.

IsXButton1Pressed

SchreibgeschütztGets the pressed state of the first extended mouse button.

IsXButton2Pressed

SchreibgeschütztGets the pressed state of the second extended mouse button.

MouseWheelDelta

SchreibgeschütztGets a value (the raw value reported by the device) that indicates the change in wheel button input from the last pointer event.

Orientation

SchreibgeschütztGets the counter-clockwise angle of rotation around the major axis of the pointer device (the z-axis, perpendicular to the surface of the digitizer).

PointerUpdateKind

SchreibgeschütztGets the kind of pointer state change.

Pressure

SchreibgeschütztGets a value that indicates the force that the pointer device (typically a pen/stylus) exerts on the surface of the digitizer.

TouchConfidence

SchreibgeschütztGets a value that indicates whether the pointer device rejected the touch contact.

Twist

SchreibgeschütztGets the clockwise rotation in degrees of a pen device around its own major axis (such as when the user spins the pen in their fingers).

XTilt

SchreibgeschütztGets the plane angle between the Y-Z plane and the plane that contains the Y axis and the axis of the input device (typically a pen/stylus).

YTilt

SchreibgeschütztGets the plane angle between the X-Z plane and the plane that contains the X axis and the axis of the input device (typically a pen/stylus).

 

Hinweise

Die PointerPointProperties-Klasse implementiert IPointerPointProperties.

Hinweis  : Es handelt sich nicht um eine agile Klasse. Daher müssen Sie das Threadingmodell und das Marshallingverhalten berücksichtigen. Weitere Informationen finden Sie unter Threading und Marshalling (C++/CX) und Die Verwendung von Windows-Runtime-Objekten in einer Multithreaded-Umgebung (.NET).

Beispiele

Im folgenden Beispiel werden mehrere erweiterte Zeigereigenschaften mit einem PointerPoint-Objekt abgefragt.


// Get extended pointer data.
function queryPointer(e) {
    // We get the extended pointer info through the getCurrentPoint method
    // of the event argument. (We recommend using getCurrentPoint 
    // to ensure the coordinate space is in relation to the target.)
    // Note: getCurrentPoint and currentPoint are only available in the 
    // local compartment, they are not available in the web compartment.
    var pt = e.getCurrentPoint(e.currentTarget);
    var ptTargetProperties = pt.properties;

    var details = "Pointer Id: " + e.pointerId;
    switch (e.pointerType) {
        case "mouse":
            details += "\nPointer type: mouse";
            details += "\nLeft button: " + ptTargetProperties.isLeftButtonPressed;
            details += "\nRight button: " + ptTargetProperties.isRightButtonPressed;
            details += "\nWheel button: " + ptTargetProperties.isMiddleButtonPressed;
            details += "\nX1 button: " + ptTargetProperties.isXButton1Pressed;
            details += "\nX2 button: " + ptTargetProperties.isXButton2Pressed;
            break;
        case "pen":
            details += "\nPointer type: pen";
            if (pt.isInContact) {
                details += "\nPressure: " + ptTargetProperties.pressure;
                details += "\nrotation: " + ptTargetProperties.rotation;
                details += "\nTilt X: " + ptTargetProperties.tiltX;
                details += "\nTilt Y: " + ptTargetProperties.tiltY;
                details += "\nBarrel button pressed: " + ptTargetProperties.isBarrelButtonPressed;
            }
            break;
        case "touch":
            details += "\nPointer type: touch";
            details += "\nPressure: " + ptTargetProperties.pressure;
            details += "\nrotation: " + ptTargetProperties.rotation;
            details += "\nTilt X: " + ptTargetProperties.tiltX;
            details += "\nTilt Y: " + ptTargetProperties.tiltY;
            break;
        default:
            details += "\nPointer type: " + "n/a";
            break;
    }
    details += "\nPointer location (target): " + e.offsetX + ", " + e.offsetY;
    details += "\nPointer location (screen): " + e.screenX + ", " + e.screenY;

    return details;
}


Anforderungen

Mindestens unterstützter Client

Windows 8 [Nur Windows Store-Apps]

Mindestens unterstützter Server

Windows Server 2012 [Nur Windows Store-Apps]

Mindestens unterstütztes Telefon

Windows Phone 8

Namespace

Windows.UI.Input
Windows::UI::Input [C++]

Metadaten

Windows.winmd

Siehe auch

Verweis
Windows.UI.Input-Klassen
Windows.UI.Input.PointerPoint.properties
Windows.Devices.Input
Windows.UI.Core
Windows.UI.Input
Windows.UI.Input.Inking
Windows.UI.Xaml.Input
TypedEventHandler
Konzept
Reagieren auf die Interaktion des Benutzers
Richtlinien für allgemeine Benutzerinteraktionen
Entwickeln von Windows Store-Apps (JavaScript und HTML)
Verwenden von Windows-Runtime in JavaScript
Fingereingabeinteraktionsentwurf
Beispiele (DOM)
Beispiel für Bildlauf, Schwenken und Zoomen in HTML
Eingabe: Beispiel für DOM-Zeiger-Ereignisbehandlung
Eingabe: Beispiel für instanziier bare Gesten
Beispiele (Windows Store-App APIs)
Eingabe: Beispiel für Gerätefunktionen
Eingabe: Beispiel für Freihandeingabe
Eingabe: Beispiel für Manipulationen und Gesten (JavaScript)
Eingabe: Vereinfachtes Beispiel für Freihandeingabe
Eingabe: Beispiel für Windows 8-Gesten
Eingabe: Beispiel für XAML-Benutzereingabeereignisse
Beispiel für Bildlauf, Schwenken und Zoomen in XAML
Beispiele (DirectX)
Beispiel für die DirectX-Fingereingabe
Eingabe: Beispiel für Manipulationen und Gesten (C++)
Eingabe: Beispiel für Treffertest
Beispiele (Win32/Desktop)
Beispiel für die Eingabequellenidentifikation
Fingereingabeeinfügungsbeispiel
Beispiel für Win32-Treffertest

 

 

Anzeigen:
© 2016 Microsoft