GeometryHitTestParameters Klasa

Definicja

Przestrzeń nazw:

System.Windows.Media

Zestaw:

PresentationCore.dll

Określa Geometry jako parametr, który ma być używany do testowania drzewa wizualnego.

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

Dziedziczenie

Object

HitTestParameters

GeometryHitTestParameters

Przykłady

W poniższym przykładzie pokazano, jak skonfigurować test trafienia przy użyciu GeometryHitTestParametersHitTest metody . Wartość Point przekazywana do OnMouseDown metody służy do tworzenia Geometry obiektu w celu rozszerzenia zakresu testu trafienia.

// 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

Właściwość IntersectionDetail zawiera GeometryHitTestResult informacje o wynikach testu trafienia, który używa Geometry parametru jako testu trafienia. Poniższa ilustracja przedstawia relację między geometrią testu trafienia (niebieski okrąg) i obiektem docelowym (czerwonym kwadratem).

Przecięcie między geometrią testu trafienia a obiektem docelowym

Uwagi

Za pomocą GeometryHitTestParameters klasy można użyć Geometry wartości do testowania trafień, aby określić, czy dowolny obiekt wizualny przecina się z wartością Geometry .

Możesz również trafić test z wartością Point , tworząc PointHitTestParameters obiekt.

Uwaga

Windows Presentation Foundation (WPF) test trafienia uwzględnia tylko wypełniony obszar geometrii podczas testu trafienia. Jeśli utworzysz punkt Geometry, test trafienia nie przeciągnie niczego, ponieważ punkt nie ma obszaru.

Konstruktory

GeometryHitTestParameters(Geometry)

Inicjuje GeometryHitTestParameters nowe wystąpienie klasy przy użyciu określonego Geometryelementu .

Właściwości

HitGeometry

Pobiera element Geometry definiujący geometrię testu trafienia dla tego GeometryHitTestParameters wystąpienia.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)