ContainerVisual.HitTest Yöntem

Tanım

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.

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

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 .

C#
// 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);
    }
}

Açıklamalar

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

Şunlara uygulanır

.NET Framework 4.8 ve diğer sürümler
Ürün Sürümler
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop 3.0, 3.1, 5, 6, 7

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

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

C#
public void HitTest (System.Windows.Media.HitTestFilterCallback filterCallback, System.Windows.Media.HitTestResultCallback resultCallback, System.Windows.Media.HitTestParameters 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.

Şunlara uygulanır

.NET Framework 4.8 ve diğer sürümler
Ürün Sürümler
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop 3.0, 3.1, 5, 6, 7