GetCurrentPoint-Methode
Inhaltsverzeichnis reduzieren
Inhaltsverzeichnis erweitern

PointerRoutedEventArgs.GetCurrentPoint Method

Ruft ein PointerPoint-Objekt ab, das grundlegende Informationen zu dem Zeiger bereitstellt, der dem Ereignis zugeordnet ist.

Syntax


public PointerPoint GetCurrentPoint(
  UIElement relativeTo
)

Parameter

relativeTo

Typ: UIElement

Ein beliebiges von der UIElement-Klasse abgeleitetes Objekt, das mit derselben Objektstruktur verbunden ist. Wenn Sie das Objekt relativ zum gesamten Koordinatensystem angeben möchten, verwenden Sie null als relativeTo-Wert.

Rückgabewert

Typ: PointerPoint

Ein PointerPoint-Wert, der den Zeigerpunkt darstellt, der diesem Ereignis zugeordnet ist. Wenn null als relativeTo übergeben wurde, sind die Koordinaten im Verweisrahmen des gesamten Fensters. Wenn ein relativeTo-Wert ungleich null übergeben wurde, gelten diese Koordinaten relativ zu dem Objekt, auf das von relativeTo verwiesen wurde.

Hinweise

Das Objekt, das von dieser Methode abgerufen wird, ermöglicht den Zugriff auf erweiterte Zeigerinformationen durch die Properties-Eigenschaft, die ein PointerPointProperties-Objekt erhält.

Im folgenden Beispiel werden erweiterte Zeigereigenschaften über die Objekte PointerPoint und PointerPointProperties abgerufen. (Das vollständige Beispiel finden Sie unter Schnellstart: Zeiger.)


         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;
         }


In der Regel wird das von dieser Methode zurückgegebene Objekt zum Eingeben von Zeigerdaten in einen GestureRecognizer verwendet. Bei einem anderen Szenario wird MouseWheelDelta für ein PointerWheelChanged-Ereignis abgerufen; dieser Wert befindet sich in PointerPointProperties.

Anforderungen

Mindestens unterstützter Client

Windows 8

Mindestens unterstützter Server

Windows Server 2012

Namespace

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

Metadaten

Windows.winmd

Siehe auch

PointerRoutedEventArgs

 

 

Anzeigen:
© 2017 Microsoft