GeometryHitTestParameters Klasse

Definition

Gibt Geometry als den Parameter an, der für Treffertests bei einer visuellen Struktur verwendet werden soll.

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
GeometryHitTestParameters

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie einen Treffertest für GeometryHitTestParameters die 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 GeometryHitTestResult enthält Informationen zu den Ergebnissen eines Treffertests, die einen Geometry Treffertest als Treffertestparameter verwendet. Die folgende Abbildung zeigt die Beziehung zwischen der Treffertestgeometrie (blauem Kreis) und dem Zielobjekt (das rote Quadrat).

Diagramm von IntersectionDetail bei Treffertests
Schnittpunkt zwischen Treffertestgeometrie und Zielobjekt

Hinweise

Mit der GeometryHitTestParameters Klasse können Sie einen Geometry Wert zum Treffertest verwenden, um zu bestimmen, ob ein visuelles Objekt mit dem Geometry Wert intersects.

Sie können auch einen Test mit einem Wert treffen, indem Sie ein Point PointHitTestParameters Objekt erstellen.

Hinweis

Windows Presentation Foundation (WPF)-Treffertests betrachtet nur den gefüllten Bereich einer Geometrie während eines Treffertests. Wenn Sie einen Punkt erstellen, würde der Treffertest nichts überschneiden, da ein Punkt Geometrykeinen Bereich aufweist.

Konstruktoren

GeometryHitTestParameters(Geometry)

Initialisiert eine neue Instanz der GeometryHitTestParameters-Klasse mit der angegebenen Geometry.

Eigenschaften

HitGeometry

Ruft die Geometry ab, die die Treffertestgeometrie für diese GeometryHitTestParameters-Instanz definiert.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für