ContainerVisual.HitTest Yöntem

Tanım

Ad Alanı:

System.Windows.Media

Bütünleştirilmiş Kod:

PresentationCore.dll

Isabet testinin en üstteki görsel nesnesini döndürür.

Aşırı Yüklemeler

HitTest(Point)	bir belirterek Pointisabet testinin en üstteki görsel nesnesini döndürür.
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	ve HitTestResultCallback nesnelerini kullanarak HitTestFilterCallback üzerinde ContainerVisual bir isabet testi başlatır.

HitTest(Point)

bir belirterek Pointisabet testinin en üstteki görsel nesnesini döndürür.

public:
 System::Windows::Media::HitTestResult ^ HitTest(System::Windows::Point point);

public System.Windows.Media.HitTestResult HitTest (System.Windows.Point point);

override this.HitTest : System.Windows.Point -> System.Windows.Media.HitTestResult

member this.HitTest : System.Windows.Point -> System.Windows.Media.HitTestResult

Public Function HitTest (point As Point) As HitTestResult

Parametreler

point

Point

Teste isabet etmek için nokta değeri.

Döndürülenler

HitTestResult

Görselin isabet testi sonucu tür HitTestResult olarak döndürülür.

Örnekler

Aşağıdaki örnekte yönteminden dönüş değerinin HitTestResult nasıl alıneceği gösterilmektedir HitTest .

// Capture the mouse event and hit test the coordinate point value against
// the child visual objects.
void MyVisualHost_MouseLeftButtonUp(object sender, System.Windows.Input.MouseButtonEventArgs e)
{
    // Retrieve the coordinates of the mouse button event.
    Point pt = e.GetPosition((UIElement)sender);

    // Initiate the hit test on the ContainerVisual's visual tree.
    HitTestResult result = _containerVisual.HitTest(pt);

    // Perform the action on the hit visual.
    if (result.VisualHit != null)
    {
        ProcessHitVisual((Visual)result.VisualHit);
    }
}

' Capture the mouse event and hit test the coordinate point value against
' the child visual objects.
Private Sub MyVisualHost_MouseLeftButtonUp(ByVal sender As Object, ByVal e As System.Windows.Input.MouseButtonEventArgs)
    ' Retrieve the coordinates of the mouse button event.
    Dim pt As Point = e.GetPosition(CType(sender, UIElement))

    ' Initiate the hit test on the ContainerVisual's visual tree.
    Dim result As HitTestResult = _containerVisual.HitTest(pt)

    ' Perform the action on the hit visual.
    If result.VisualHit IsNot Nothing Then
        ProcessHitVisual(CType(result.VisualHit, Visual))
    End If
End Sub

Açıklamalar

VisualHit dönüş değerinin özelliği, isabet edilen Visual nesneyi temsil eder.

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

ve HitTestResultCallback nesnelerini kullanarak HitTestFilterCallback üzerinde ContainerVisual bir isabet testi başlatır.

public:
 void HitTest(System::Windows::Media::HitTestFilterCallback ^ filterCallback, System::Windows::Media::HitTestResultCallback ^ resultCallback, System::Windows::Media::HitTestParameters ^ hitTestParameters);

public void HitTest (System.Windows.Media.HitTestFilterCallback filterCallback, System.Windows.Media.HitTestResultCallback resultCallback, System.Windows.Media.HitTestParameters hitTestParameters);

override this.HitTest : System.Windows.Media.HitTestFilterCallback * System.Windows.Media.HitTestResultCallback * System.Windows.Media.HitTestParameters -> unit

member this.HitTest : System.Windows.Media.HitTestFilterCallback * System.Windows.Media.HitTestResultCallback * System.Windows.Media.HitTestParameters -> unit

Public Sub HitTest (filterCallback As HitTestFilterCallback, resultCallback As HitTestResultCallback, hitTestParameters As HitTestParameters)

Parametreler

filterCallback

HitTestFilterCallback

Görsel ağacının isabet testi sonuçlarınızda işlemekle ilgilenmediğiniz bölümlerini yoksaymanıza olanak tanıyan temsilci.

resultCallback

HitTestResultCallback

İsabet testi bilgilerinin döndürülmesi için kullanılan temsilci.

hitTestParameters

HitTestParameters

Bir isabet testi için parametre kümesini tanımlar.

Açıklamalar

filterCallback Parametre null olabilir, bu durumda yoksayılır. nulldeğilsefilterCallback, öncesinde resultCallbackçağrılır.