GeometryHitTestParameters Sınıf

Tanım

Ad Alanı:

System.Windows.Media

Bütünleştirilmiş Kod:

PresentationCore.dll

Bir Geometry görsel ağacı isabet sınaması için kullanılacak parametre olarak bir belirtir.

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

Devralma

Object

HitTestParameters

GeometryHitTestParameters

Örnekler

Aşağıdaki örnekte yöntemi için kullanarak GeometryHitTestParameters bir isabet testinin nasıl ayarlanacağı gösterilmektedir HitTest . Point yöntemine OnMouseDown geçirilen değer, isabet testi aralığını genişletmek üzere bir Geometry nesne oluşturmak için kullanılır.

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

özelliğiGeometryHitTestResult, IntersectionDetail isabet testi parametresi olarak kullanan Geometry bir isabet testinin sonuçları hakkında bilgi sağlar. Aşağıdaki çizimde isabet testi geometrisi (mavi daire) ile hedef nesne (kırmızı kare) arasındaki ilişki gösterilmektedir.

İsabet testi geometrisi ile hedef nesne arasındaki kesişim

Açıklamalar

sınıfıyla, herhangi bir görsel nesnenin GeometryHitTestParameters değerle Geometry kesişip kesişmediğini belirlemek için isabet testi için bir Geometry değer kullanabilirsiniz.

Bir nesne oluşturarak PointHitTestParameters bir Point değerle teste de basabilirsiniz.

Uyarı

Windows Presentation Foundation (WPF) isabet testi yalnızca isabet testi sırasında geometrinin dolu alanını dikkate alır. Bir nokta oluşturursanız, bir noktanın Geometryalanı olmadığından isabet testi hiçbir şeyi kesiştirmeyecektir.

Oluşturucular

Name	Description
GeometryHitTestParameters(Geometry)	Belirtilen Geometrykullanarak sınıfının yeni bir örneğini GeometryHitTestParameters başlatır.

Özellikler

Name	Description
HitGeometry	Geometry Bu GeometryHitTestParameters örnek için isabet testi geometrisini tanımlayan öğesini alır.