PointerRoutedEventArgs Klasse

Referenz

Definition

Namespace:: Microsoft.UI.Xaml.Input

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Enthält die Argumente, die von der letzten Zeigerereignismeldung zurückgegeben werden.

public ref class PointerRoutedEventArgs sealed : RoutedEventArgs

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class PointerRoutedEventArgs final : RoutedEventArgs

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class PointerRoutedEventArgs : RoutedEventArgs

Public NotInheritable Class PointerRoutedEventArgs
Inherits RoutedEventArgs

Vererbung: Object Platform::Object IInspectable RoutedEventArgs PointerRoutedEventArgs

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Beispiele

Das folgende Codebeispiel zeigt Szenario 2 aus dem Eingabebeispiel. Dieser Code zeigt einige Verwendungsmuster für die direkte Bearbeitung mithilfe der Ereignisse PointerPressed, PointerReleased, PointerEntered, PointerExited und PointerMoved .

<StackPanel x:Name="Scenario2Output" ManipulationMode="All">
  <StackPanel Orientation="Horizontal" Margin="0,10,0,0">
    <Button x:Name="scenario2Reset" Content="Reset" 
      Margin="0,0,10,0" Click="Scenario2Reset"/>
  </StackPanel>
  <StackPanel Orientation="Horizontal" >
    <ToggleSwitch x:Name="tbPointerCapture" 
      Header="Pointer Capture" FontSize="20"/>
    <TextBlock x:Name="txtCaptureStatus" 
      Style="{StaticResource BasicTextStyle}"/>
  </StackPanel>
  <Border x:Name="bEnteredExited" Background="Red" 
    Height="300" Width="450" CornerRadius="20" 
    HorizontalAlignment="Left">
    <Grid>
      <TextBlock Style="{StaticResource BasicTextStyle}" Text="" 
        HorizontalAlignment="Center" VerticalAlignment="Center" 
        x:Name="bEnteredExitedTextBlock"/>
      <Ellipse VerticalAlignment="Bottom" Stroke="Silver" 
        StrokeDashArray="2,2" StrokeThickness="2" Margin="2" 
        x:Name="bEnteredExitedTimer" Width="20" Height="20" 
        RenderTransformOrigin="0.5,0.5">
        <Ellipse.RenderTransform >
          <RotateTransform Angle="0" />
        </Ellipse.RenderTransform>
      </Ellipse>
    </Grid>
  </Border>
</StackPanel>

int _pointerCount;

public Scenario2()
{
    this.InitializeComponent();
    bEnteredExited.PointerEntered += bEnteredExited_PointerEntered;
    bEnteredExited.PointerExited += bEnteredExited_PointerExited;
    bEnteredExited.PointerPressed += bEnteredExited_PointerPressed;
    bEnteredExited.PointerReleased += bEnteredExited_PointerReleased;
    bEnteredExited.PointerMoved += bEnteredExited_PointerMoved;

    // To code for multiple Pointers (that is, fingers), 
    // we track how many entered/exited.
    _pointerCount = 0;
}

private void bEnteredExited_PointerMoved(object sender, 
    PointerRoutedEventArgs e)
{
    Scenario2UpdateVisuals(sender as Border, "Moved");
}

private void bEnteredExited_PointerReleased(object sender, 
    PointerRoutedEventArgs e)
{
    ((Border)sender).ReleasePointerCapture(e.Pointer);
    txtCaptureStatus.Text = string.Empty;
}

//Can only get capture on PointerPressed (i.e. touch down, mouse click, pen press)
private void bEnteredExited_PointerPressed(object sender, 
    PointerRoutedEventArgs e)
{
    if (tbPointerCapture.IsOn)
    {
        bool _hasCapture = ((Border)sender).CapturePointer(e.Pointer);
        txtCaptureStatus.Text = "Got Capture: " + _hasCapture;
    }
}

private void bEnteredExited_PointerExited(object sender, 
    PointerRoutedEventArgs e)
{
    _pointerCount--;
    Scenario2UpdateVisuals(sender as Border, "Exited");
}

private void bEnteredExited_PointerEntered(object sender, 
    PointerRoutedEventArgs e)
{
    _pointerCount++;
    Scenario2UpdateVisuals(sender as Border, "Entered");
}

private void Scenario2UpdateVisuals(Border border, 
    String eventDescription)
{
    switch (eventDescription.ToLower())
    {
        case "exited":
            if (_pointerCount <= 0)
            {
                border.Background = new SolidColorBrush(Colors.Red);
                bEnteredExitedTextBlock.Text = eventDescription;
            }
            break;
        case "moved":
            RotateTransform rt = 
                (RotateTransform)bEnteredExitedTimer.RenderTransform;
            rt.Angle += 2;
            if (rt.Angle > 360) rt.Angle -= 360;
            break;
        default:
            border.Background = new SolidColorBrush(Colors.Green);
            bEnteredExitedTextBlock.Text = eventDescription;
            break;
    }
}

private void Scenario2Reset(object sender, RoutedEventArgs e)
{
    Scenario2Reset();
}

private void Scenario2Reset()
{
    bEnteredExited.Background = new SolidColorBrush(Colors.Green);
    bEnteredExitedTextBlock.Text = string.Empty;
}

Hinweise

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

Wenn das Ereignisargument die von Ihrer App benötigten Zeigerdetails nicht intrinsisch verfügbar macht, können Sie über die Methoden PointerRoutedEventArgsGetCurrentPoint und GetIntermediatePoints zugriff auf erweiterte Zeigerdaten erhalten. Verwenden Sie diese Methoden, um den Kontext der Zeigerdaten anzugeben.

Die PointerRoutedEventArgs Ereignisdatenklasse wird für die folgenden Ereignisse verwendet:

Wichtig

Die Mauseingabe wird einem einzelnen Zeiger zugeordnet, der bei der ersten Ermittlung einer Mauseingabe zugewiesen wird. Durch das Klicken auf eine Maustaste (links, Mausrad oder rechts) wird über das PointerPressed-Ereignis eine zweite Zuordnung zwischen dem Zeiger und dieser Taste erstellt. Das PointerReleased-Ereignis wird nur ausgelöst, wenn dieselbe Maustaste losgelassen wird (dem Zeiger kann erst eine andere Taste zugeordnet werden, wenn dieses Ereignis abgeschlossen ist). Aufgrund dieser exklusiven Zuordnung werden Klicks auf andere Maustasten über das PointerMoved-Ereignis geleitet. Sie können den Maustastenzustand testen, wenn Sie dieses Ereignis behandeln, wie im folgenden Beispiel gezeigt.

private void Target_PointerMoved(object sender, PointerRoutedEventArgs e)
{
    Pointer ptr = e.Pointer;

    // Multiple, simultaneous mouse button inputs are processed here.
    // Mouse input is associated with a single pointer assigned when 
    // mouse input is first detected. 
    // Clicking additional mouse buttons (left, wheel, or right) during 
    // the interaction creates secondary associations between those buttons 
    // and the pointer through the pointer pressed event. 
    // The pointer released event is fired only when the last mouse button 
    // associated with the interaction (not necessarily the initial button) 
    // is released. 
    // Because of this exclusive association, other mouse button clicks are 
    // routed through the pointer move event.          
    if (ptr.PointerDeviceType == PointerDeviceType.Mouse)
    {
        // To get mouse state, we need extended pointer details.
        // We get the pointer info through the getCurrentPoint method
        // of the event argument. 
        PointerPoint ptrPt = e.GetCurrentPoint(Target);
        if (ptrPt.Properties.IsLeftButtonPressed)
        {
            eventLog.Text += "\nLeft button: " + ptrPt.PointerId;
        }
        if (ptrPt.Properties.IsMiddleButtonPressed)
        {
            eventLog.Text += "\nWheel button: " + ptrPt.PointerId;
        }
        if (ptrPt.Properties.IsRightButtonPressed)
        {
            eventLog.Text += "\nRight button: " + ptrPt.PointerId;
        }
    }

    // Prevent most handlers along the event route from handling the same event again.
    e.Handled = true;

    // Display pointer details.
    updateInfoPop(e);
}

Der Wert des Absenders (der sich auf der Delegatensignatur befindet, nicht in dieser Ereignisdatenklasse).
Bestimmte Elemente von PointerRoutedEventArgs, z. B . KeyModifiers oder GetCurrentPoint.
Werte einer Pointer-Gerätebeschreibungsklasse. Rufen Sie den Zeiger aus der Pointer-Eigenschaft ab.
Elemente, die aus der Konzeptualisierung der Systemeingabe eines PointerPoint stammen. Verwenden Sie die GetCurrentPoint-API , um einen PointerPoint-Wert abzurufen, und rufen Sie dann pointerPoint-API wie PointerPoint.Position und PointerPointProperties auf.

Bestimmte Ereignisse verfügen häufig über Informationen in den verschiedenen Zeigergeräte- und Zeigerpunktklassen, die hauptsächlich nur für dieses Ereignis relevant sind. Wenn Sie z. B . PointerWheelChanged behandeln, interessieren Sie möglicherweise die MouseWheelDelta von PointerPointProperties.

Das von den GetCurrentPoint Methoden und GetIntermediatePoints abgerufene Objekt ermöglicht den Zugriff auf erweiterte Zeigerinformationen über die Properties-Eigenschaft , die ein PointerPointProperties-Objekt abruft .

Im folgenden Beispiel erhalten wir erweiterte Zeigereigenschaften über die Objekte PointerPoint und PointerPointProperties . (Das vollständige Beispiel finden Sie unter Handle-Zeigereingabe .)

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

    switch (ptrPt.PointerDeviceType)
    {
        case PointerDeviceType.Mouse:
            details += "\nPointer type: mouse";
            break;
        case 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 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(panel);
    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 verwendet, um Zeigerdaten an einen GestureRecognizer zu übergeben. Ein anderes Szenario ist das Abrufen der MouseWheelDelta für ein PointerWheelChanged-Ereignis . dieser Wert befindet sich in PointerPointProperties.

Eigenschaften

Handled	Ruft einen Wert ab, der das weitergeleitete Ereignis als behandelt markiert, oder legt diesen fest und verhindert, dass die meisten Handler entlang der Ereignisroute dasselbe Ereignis erneut behandeln.
IsGenerated	Ruft einen Wert ab, der angibt, ob das Zeigerereignis durch eine direkte Interaktion mit einem Objekt durch den Benutzer aufgetreten ist oder von der Plattform basierend auf Änderungen an der Benutzeroberfläche der Anwendung generiert wurde.
KeyModifiers	Ruft einen Wert ab, der angibt, welche Schlüsselmodifizierer zum Zeitpunkt der Initiierten des Zeigerereignisses aktiv waren.
OriginalSource	Ruft einen Verweis auf das -Objekt ab, das das Ereignis ausgelöst hat. Dies ist häufig ein Vorlagenteil eines Steuerelements und nicht ein Element, das in Ihrer App-Benutzeroberfläche deklariert wurde. (Geerbt von RoutedEventArgs)
Pointer	Ruft einen Verweis auf ein Zeigertoken ab.

Methoden

GetCurrentPoint(UIElement)	Ruft ein PointerPoint-Objekt ab, das grundlegende Informationen zu dem dem Ereignis zugeordneten Zeiger bereitstellt.
GetIntermediatePoints(UIElement)	Ruft eine Auflistung von PointerPoint-Objekten ab, die den Zeigerverlauf vom letzten Zeigerereignis bis hin zum aktuellen Zeigerereignis darstellen. Jeder PointerPoint in der Auflistung stellt grundlegende Informationen zum Zeiger bereit, der dem Ereignis zugeordnet ist. Das letzte Element in der Auflistung entspricht dem von GetCurrentPoint zurückgegebenen PointerPoint-Objekt.

Gilt für:

Freigeben über