PointerPoint Klasse

  • Referenz

Definition

Namespace:
Windows.UI.Input
Bearbeiten

Stellt grundlegende Eigenschaften für den Eingabezeiger bereit, der einem einzelnen Maus-, Stift- oder Touchkontakt zugeordnet ist.

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

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Im folgenden Beispiel werden verschiedene Zeigereigenschaften mithilfe eines PointerPoint-Objekts abfragt.

String queryPointer(PointerPoint ptrPt)
{
    String details = "";

    switch (ptrPt.PointerDevice.PointerDeviceType)
    {
        case Windows.Devices.Input.PointerDeviceType.Mouse:
            details += "\nPointer type: mouse";
            break;
        case Windows.Devices.Input.PointerDeviceType.Pen:
            details += "\nPointer type: pen";
            if (ptrPt.IsInContact)
            {
                details += "\nPressure: " + ptrPt.Properties.Pressure;
                details += "\nrotation: " + ptrPt.Properties.Orientation;
                details += "\nTilt X: " + ptrPt.Properties.XTilt;
                details += "\nTilt Y: " + ptrPt.Properties.YTilt;
                details += "\nBarrel button pressed: " + ptrPt.Properties.IsBarrelButtonPressed;
            }
            break;
        case Windows.Devices.Input.PointerDeviceType.Touch:
            details += "\nPointer type: touch";
            details += "\nrotation: " + ptrPt.Properties.Orientation;
            details += "\nTilt X: " + ptrPt.Properties.XTilt;
            details += "\nTilt Y: " + ptrPt.Properties.YTilt;
            break;
        default:
            details += "\nPointer type: n/a";
            break;
    }

    GeneralTransform gt = Target.TransformToVisual(page);
    Point screenPoint;

    screenPoint = gt.TransformPoint(new Point(ptrPt.Position.X, ptrPt.Position.Y));
    details += "\nPointer Id: " + ptrPt.PointerId.ToString() +
        "\nPointer location (parent): " + ptrPt.Position.X + ", " + ptrPt.Position.Y +
        "\nPointer location (screen): " + screenPoint.X + ", " + screenPoint.Y;
    return details;
}

String queryPointer(PointerPoint ptrPt)
{
    String details = "";

    switch (ptrPt.PointerDevice.PointerDeviceType)
    {
        case Windows.Devices.Input.PointerDeviceType.Mouse:
            details += "\nPointer type: mouse";
            break;
        case Windows.Devices.Input.PointerDeviceType.Pen:
            details += "\nPointer type: pen";
            if (ptrPt.IsInContact)
            {
                details += "\nPressure: " + ptrPt.Properties.Pressure;
                details += "\nrotation: " + ptrPt.Properties.Orientation;
                details += "\nTilt X: " + ptrPt.Properties.XTilt;
                details += "\nTilt Y: " + ptrPt.Properties.YTilt;
                details += "\nBarrel button pressed: " + ptrPt.Properties.IsBarrelButtonPressed;
            }
            break;
        case Windows.Devices.Input.PointerDeviceType.Touch:
            details += "\nPointer type: touch";
            details += "\nrotation: " + ptrPt.Properties.Orientation;
            details += "\nTilt X: " + ptrPt.Properties.XTilt;
            details += "\nTilt Y: " + ptrPt.Properties.YTilt;
            break;
        default:
            details += "\nPointer type: n/a";
            break;
    }

    GeneralTransform gt = Target.TransformToVisual(page);
    Point screenPoint;

    screenPoint = gt.TransformPoint(new Point(ptrPt.Position.X, ptrPt.Position.Y));
    details += "\nPointer Id: " + ptrPt.PointerId.ToString() +
        "\nPointer location (parent): " + ptrPt.Position.X + ", " + ptrPt.Position.Y +
        "\nPointer location (screen): " + screenPoint.X + ", " + screenPoint.Y;
    return details;
}

Hinweise

Die PointerPoint-Klasse implementiert IPointerPoint.

Informationen zu erweiterten Eigenschaften, auf die über Eigenschaften zugegriffen werden kann, finden Sie unter PointerPointProperties.

In den meisten Fällen wird empfohlen, Zeigerinformationen über das Ereignisargument der Zeigerereignishandler im ausgewählten Sprachframework abzurufen.

Wenn das Ereignisargument die für Ihre App erforderlichen Zeigerdetails nicht intrinsisch verfügbar macht, können Sie über die Methoden GetCurrentPoint und GetIntermediatePoints von PointerRoutedEventArgs Zugriff auf erweiterte Zeigerdaten erhalten. Verwenden Sie diese Methoden, um den Kontext der Zeigerdaten anzugeben.

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

Hinweis

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

Eigenschaften

FrameId

Ruft die ID eines Eingabeframes ab.
IsInContact

Ruft einen Wert ab, der angibt, ob das Eingabegerät (Toucheingabe, Stift/Eingabestift) die Digitizeroberfläche berührt oder eine Maustaste nach unten gedrückt wird.
PointerDevice

Ruft Informationen zum Gerät ab, das dem Eingabezeiger zugeordnet ist.
PointerId

Ruft einen eindeutigen Bezeichner für den Eingabezeiger ab.
Position

Ruft die Position der Zeigereingabe in Clientkoordinaten ab.
Properties

Ruft erweiterte Informationen zum Eingabezeiger ab.
RawPosition

Ruft die Clientkoordinaten des Eingabezeigers ab, wie vom Eingabegerät gemeldet.
Timestamp

Ruft die Uhrzeit ab, zu der die Eingabe aufgetreten ist.

Methoden

GetCurrentPoint(UInt32)

Ruft Positions- und Zustandsinformationen für den angegebenen Zeiger ab.

In den meisten Fällen wird empfohlen, Zeigerinformationen über das Ereignisargument der Zeigerereignishandler im ausgewählten Sprachframework abzurufen (Windows-App mit JavaScript, UWP-App mit C++, C#oder Visual Basic oder UWP-App mit DirectX mit C++).

Wenn das Ereignisargument die für Ihre App erforderlichen Zeigerdetails nicht intrinsisch verfügbar macht, können Sie über die Methoden GetCurrentPoint und GetIntermediatePoints von PointerRoutedEventArgs Zugriff auf erweiterte Zeigerdaten erhalten. Verwenden Sie diese Methoden, um den Kontext der Zeigerdaten anzugeben.

Die statischen PointerPoint-Methoden GetCurrentPoint und GetIntermediatePoints verwenden immer den App-Kontext.
GetCurrentPoint(UInt32, IPointerPointTransform)

Ruft die transformierten Informationen für den angegebenen Zeiger ab.

In den meisten Fällen wird empfohlen, Zeigerinformationen über das Ereignisargument der Zeigerereignishandler im ausgewählten Sprachframework abzurufen (Windows-App mit JavaScript, UWP-App mit C++, C#oder Visual Basic oder UWP-App mit DirectX mit C++).

Wenn das Ereignisargument die für Ihre App erforderlichen Zeigerdetails nicht intrinsisch verfügbar macht, können Sie über die Methoden GetCurrentPoint und GetIntermediatePoints von PointerRoutedEventArgs Zugriff auf erweiterte Zeigerdaten erhalten. Verwenden Sie diese Methoden, um den Kontext der Zeigerdaten anzugeben.

Die statischen PointerPoint-MethodenGetCurrentPoint und GetIntermediatePoints verwenden immer den App-Kontext.
GetIntermediatePoints(UInt32)

Ruft Positions- und Zustandsinformationen für den angegebenen Zeiger ab, vom letzten Zeigerereignis bis hin zum aktuellen Zeigerereignis.

In den meisten Fällen wird empfohlen, Zeigerinformationen über das Ereignisargument der Zeigerereignishandler im ausgewählten Sprachframework abzurufen (Windows-App mit JavaScript, UWP-App mit C++, C#oder Visual Basic oder UWP-App mit DirectX mit C++).

Wenn das Ereignisargument die für Ihre App erforderlichen Zeigerdetails nicht intrinsisch verfügbar macht, können Sie über die Methoden GetCurrentPoint und GetIntermediatePoints von PointerRoutedEventArgs Zugriff auf erweiterte Zeigerdaten erhalten. Verwenden Sie diese Methoden, um den Kontext der Zeigerdaten anzugeben.

Die statischen PointerPoint-MethodenGetCurrentPoint und GetIntermediatePoints verwenden immer den App-Kontext.
GetIntermediatePoints(UInt32, IPointerPointTransform)

Ruft die transformierten Positions- und Zustandsinformationen für den angegebenen Zeiger ab, vom letzten Zeigerereignis bis hin zum aktuellen Zeigerereignis.

In den meisten Fällen wird empfohlen, Zeigerinformationen über das Ereignisargument der Zeigerereignishandler im ausgewählten Sprachframework abzurufen (Windows-App mit JavaScript, UWP-App mit C++, C#oder Visual Basic oder UWP-App mit DirectX mit C++).

Wenn das Ereignisargument die für Ihre App erforderlichen Zeigerdetails nicht intrinsisch verfügbar macht, können Sie über die Methoden GetCurrentPoint und GetIntermediatePoints von PointerRoutedEventArgs Zugriff auf erweiterte Zeigerdaten erhalten. Verwenden Sie diese Methoden, um den Kontext der Zeigerdaten anzugeben.

Die statischen PointerPoint-MethodenGetCurrentPoint und GetIntermediatePoints verwenden immer den App-Kontext.

Gilt für:

Weitere Informationen