HitTestFilterCallback Delegat

Referenz

Definition

Namespace:: System.Windows.Media

Assembly:: PresentationCore.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt die Rückrufmethode dar, die Teile der visuellen Struktur angibt, für die keine Treffertestverarbeitung ausgeführt werden soll.

public delegate System::Windows::Media::HitTestFilterBehavior HitTestFilterCallback(DependencyObject ^ potentialHitTestTarget);

public delegate System.Windows.Media.HitTestFilterBehavior HitTestFilterCallback(DependencyObject potentialHitTestTarget);

type HitTestFilterCallback = delegate of DependencyObject -> HitTestFilterBehavior

Public Delegate Function HitTestFilterCallback(potentialHitTestTarget As DependencyObject) As HitTestFilterBehavior

Parameter

potentialHitTestTarget: DependencyObject

Das visuelle Element für die Treffertestverarbeitung.

Rückgabewert

HitTestFilterBehavior

Ein HitTestFilterBehavior, das die Aktion darstellt, die sich aus dem Treffertest ergibt .

Beispiele

Das folgende Beispiel zeigt, wie sie mithilfe eines HitTestFilterCallback Werts aufgerufen werdenHitTest. Die entsprechende Treffertestrückrufmethode wird ebenfalls definiert.

// Respond to the mouse wheel event by setting up a hit test filter and results enumeration.
private void OnMouseWheel(object sender, MouseWheelEventArgs e)
{
    // Retrieve the coordinate of the mouse position.
    Point pt = e.GetPosition((UIElement)sender);

    // 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(myCanvas,
                      new HitTestFilterCallback(MyHitTestFilter),
                      new HitTestResultCallback(MyHitTestResult),
                      new PointHitTestParameters(pt));

    // Perform actions on the hit test results list.
    if (hitResultsList.Count > 0)
    {
        ProcessHitTestResultsList();
    }
}

' Respond to the mouse wheel event by setting up a hit test filter and results enumeration.
Private Overloads Sub OnMouseWheel(ByVal sender As Object, ByVal e As MouseWheelEventArgs)
    ' Retrieve the coordinate of the mouse position.
    Dim pt As Point = e.GetPosition(CType(sender, UIElement))

    ' 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(myCanvas, New HitTestFilterCallback(AddressOf MyHitTestFilter), New HitTestResultCallback(AddressOf MyHitTestResult), New PointHitTestParameters(pt))

    ' Perform actions on the hit test results list.
    If hitResultsList.Count > 0 Then
        ProcessHitTestResultsList()
    End If
End Sub

Das folgende Beispiel zeigt, wie Sie einen HitTestFilterBehavior Wert aus einer Rückrufmethode für den Treffertestfilter zurückgeben.

// Filter the hit test values for each object in the enumeration.
public HitTestFilterBehavior MyHitTestFilter(DependencyObject o)
{
    // Test for the object value you want to filter.
    if (o.GetType() == typeof(Label))
    {
        // Visual object and descendants are NOT part of hit test results enumeration.
        return HitTestFilterBehavior.ContinueSkipSelfAndChildren;
    }
    else
    {
        // Visual object is part of hit test results enumeration.
        return HitTestFilterBehavior.Continue;
    }
}

' Filter the hit test values for each object in the enumeration.
Public Function MyHitTestFilter(ByVal o As DependencyObject) As HitTestFilterBehavior
    ' Test for the object value you want to filter.
    If o.GetType() Is GetType(Label) Then
        ' Visual object and descendants are NOT part of hit test results enumeration.
        Return HitTestFilterBehavior.ContinueSkipSelfAndChildren
    Else
        ' Visual object is part of hit test results enumeration.
        Return HitTestFilterBehavior.Continue
    End If
End Function

Hinweise

Die Rückrufmethode für Den Treffertestfilter wird für alle visuellen Objekte aufgerufen, die den Treffertestkriterien zugeordnet sind, beginnend mit dem visuellen, von Ihnen angegebenen und absteigenden Zweig der visuellen Struktur. Sie können jedoch auch bestimmte Verzweigungen der visuellen Struktur ignorieren, die im Rahmen Ihrer Treffertestergebnis-Rückruffunktion nicht verarbeitet werden sollen. Der Rückgabewert der Treffertestfilter-Rückruffunktion bestimmt, welcher Typ von Aktion von der Enumeration der visuellen Objekte ausgeführt werden soll. Wenn Sie z. B. den Wert zurückgeben, ContinueSkipSelfAndChildrenkönnen Sie das aktuelle visuelle Objekt und seine Untergeordneten aus der Ergebnisaufzählung des Treffertests entfernen. Dies bedeutet, dass die Rückrufmethode für Treffertests diese Objekte in der Enumeration nicht sehen wird.

Hinweis

Durch das Reduzieren der Verzweigungen in der visuellen Struktur von Objekten wird der Verarbeitungsaufwand während der Übergabe der Auflistung von Treffertestergebnissen verringert.

Bereinigen einer visuellen Struktur mithilfe eines Treffertestfilters
Reduzieren der Verzweigungen in einer visuellen Struktur