Freigeben über


HitTestFilterBehavior Enumeration

Definition

Gibt das Rückgabeverhalten eines Treffertests in einer Treffertest-Filterrückrufmethode an.

public enum class HitTestFilterBehavior
public enum HitTestFilterBehavior
type HitTestFilterBehavior = 
Public Enum HitTestFilterBehavior
Vererbung
HitTestFilterBehavior

Felder

Continue 6

Treffertest für das aktuelle Visual und seine Nachfolger.

ContinueSkipChildren 2

Treffertest für das aktuelle Visual, jedoch nicht für seine Nachfolger.

ContinueSkipSelf 4

Kein Treffertest für das aktuelle Visual, jedoch für seine Nachfolger.

ContinueSkipSelfAndChildren 0

Kein Treffertest für das aktuelle Visual und seine Nachfolger.

Stop 8

Beendet den Treffertest beim aktuellen Visual.

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein Wert aus einer Rückrufmethode für den HitTestFilterBehavior Treffertestfilter zurückgegeben wird. In diesem Fall überspringt der Filter Bezeichnungen und deren Nachfolger und überprüft alles andere.

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

Der Rückgabewert des Treffertestfilter-Rückrufs ist ein HitTestFilterBehaviorRückruf, der bestimmt, welche Art von Aktion beim Verarbeiten der visuellen Struktur zum Treffertest ausgeführt werden soll. Wenn ihr Treffertestfilter-Rückruf beispielsweise den Wert ContinueSkipSelfAndChildrenzurückgibt, können Sie das aktuelle visuelle Objekt und dessen Nachfolger aus der Ergebnisbewertung entfernen.

Hinweis

Durch das Abschneiden der visuellen Struktur von Objekten wird die Menge der Verarbeitung verringert, die während des Treffertestergebnisauswertungspasses erforderlich ist.

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

Gilt für