HitTestFilterBehavior Výčet

  • Reference

Definice

Obor názvů:
System.Windows.Media
Sestavení:
PresentationCore.dll

Určuje návratové chování testu hitu v metodě zpětného volání filtru testu.

public enum class HitTestFilterBehavior
public enum HitTestFilterBehavior
type HitTestFilterBehavior = 
Public Enum HitTestFilterBehavior
Dědičnost
Object
ValueType
Enum
HitTestFilterBehavior

Pole

Continue 6

Hit test proti proudu Visual a jeho potomci.
ContinueSkipChildren 2

Hit test proti aktuální Visual, ale ne jeho potomci.
ContinueSkipSelf 4

Nenasadíte test proti aktuálnímu Visual, ale narazíte na test proti jeho potomkům.
ContinueSkipSelfAndChildren 0

Nenasadíte test proti aktuálnímu Visual nebo jeho potomkovi.
Stop 8

Přestaňte testovat v aktuálním stavu Visual.

Příklady

Následující příklad ukazuje, jak vrátit HitTestFilterBehavior hodnotu z metody zpětného volání filtru testu. V tomto případě filtr přeskočí popisky a jejich potomky a nasáhne testy všeho ostatního.

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

Poznámky

Návratová hodnota zpětného volání filtru testu je hodnota HitTestFilterBehavior, která určuje, jaký typ akce se má provést při zpracování vizuálního stromu pro testování hitů. Pokud například zpětné volání filtru testu vrátí hodnotu ContinueSkipSelfAndChildren, můžete z vyhodnocení výsledků testu odebrat aktuální objekt vizuálu a jeho potomky.

Poznámka

Vyřezávání vizuálního stromu objektů snižuje množství zpracování, které se vyžaduje během úspěšného vyhodnocení výsledků testu.

Vyřazení vizuálního stromu pomocí filtru testu hitu
Vyřazení vizuálního stromu

Platí pro