GeometryHitTestParameters Klasse

Definition

public ref class GeometryHitTestParameters : System::Windows::Media::HitTestParameters

public class GeometryHitTestParameters : System.Windows.Media.HitTestParameters

type GeometryHitTestParameters = class
    inherit HitTestParameters

Public Class GeometryHitTestParameters
Inherits HitTestParameters

Vererbung

Object

HitTestParameters

GeometryHitTestParameters

Beispiele

Das folgende Beispiel zeigt, wie Sie einen Treffertest mithilfe GeometryHitTestParameters der HitTest Methode einrichten. Der Point Wert, der an die OnMouseDown Methode übergeben wird, wird verwendet, um ein Geometry Objekt zu erstellen, um den Bereich des Treffertests zu erweitern.

// Respond to the mouse button down event by setting up a hit test results callback.
private void OnMouseDown(object sender, MouseButtonEventArgs e)
{
    // Retrieve the coordinate of the mouse position.
    Point pt = e.GetPosition((UIElement)sender);

    // Expand the hit test area by creating a geometry centered on the hit test point.
    EllipseGeometry expandedHitTestArea = new EllipseGeometry(pt, 10.0, 10.0);

    // Clear the contents of the list used for hit test results.
    hitResultsList.Clear();

    // Set up a callback to receive the hit test result enumeration.
    VisualTreeHelper.HitTest(myControl, null,
        new HitTestResultCallback(MyHitTestResultCallback),
        new GeometryHitTestParameters(expandedHitTestArea));

    // Perform actions on the hit test results list.
    if (hitResultsList.Count > 0)
    {
        ProcessHitTestResultsList();
    }
}

' Respond to the mouse button down event by setting up a hit test results callback.
Private Overloads Sub OnMouseDown(ByVal sender As Object, ByVal e As MouseButtonEventArgs)
    ' Retrieve the coordinate of the mouse position.
    Dim pt As Point = e.GetPosition(CType(sender, UIElement))

    ' Expand the hit test area by creating a geometry centered on the hit test point.
    Dim expandedHitTestArea As New EllipseGeometry(pt, 10.0, 10.0)

    ' Clear the contents of the list used for hit test results.
    hitResultsList.Clear()

    ' Set up a callback to receive the hit test result enumeration.
    VisualTreeHelper.HitTest(myControl, Nothing, New HitTestResultCallback(AddressOf MyHitTestResultCallback), New GeometryHitTestParameters(expandedHitTestArea))

    ' Perform actions on the hit test results list.
    If hitResultsList.Count > 0 Then
        ProcessHitTestResultsList()
    End If
End Sub

Die IntersectionDetail Eigenschaft von GeometryHitTestResult stellt Informationen zu den Ergebnissen eines Treffertests bereit, die einen Geometry als Treffertestparameter verwenden. Die folgende Abbildung zeigt die Beziehung zwischen der Treffertestgeometrie (dem blauen Kreis) und dem Zielobjekt (das rote Quadrat).

Schnittmenge zwischen Treffertestgeometrie und Zielobjekt

Hinweise

Mit der GeometryHitTestParameters Klasse können Sie einen Geometry Wert für Treffertests verwenden, um zu bestimmen, ob sich ein visuelles Objekt mit dem Geometry Wert überschneidet.

Sie können auch den Test mit einem Point Wert ausführen, indem Sie ein PointHitTestParameters Objekt erstellen.