Język

HitTestFilterBehavior Wyliczenie

Definicja

Przestrzeń nazw:
System.Windows.Media
Zestaw:
PresentationCore.dll

Określa zachowanie zwracane testu trafienia w metodzie wywołania zwrotnego filtru testu trafienia.

public enum class HitTestFilterBehavior
public enum HitTestFilterBehavior
type HitTestFilterBehavior = 
Public Enum HitTestFilterBehavior
Dziedziczenie
Object
ValueType
Enum
HitTestFilterBehavior

Pola

Nazwa Wartość Opis
ContinueSkipSelfAndChildren 0

Nie przetestuj względem bieżącego Visual lub jego elementów potomnych.
ContinueSkipChildren 2

Przetestuj test względem bieżącego Visualelementu , ale nie jego elementów potomnych.
ContinueSkipSelf 4

Nie przetestuj względem bieżącego Visualelementu , ale przetestuj względem jego elementów potomnych.
Continue 6

Przetestuj test względem prądu Visual i jego elementów potomnych.
Stop 8

Zatrzymaj testowanie trafień w bieżącym Visualpliku .

Przykłady

W poniższym przykładzie pokazano, jak zwrócić HitTestFilterBehavior wartość z metody wywołania zwrotnego filtru testu trafienia. W takim przypadku filtr pomija etykiety i ich elementy podrzędne i sprawdza wszystkie inne elementy.

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

Uwagi

Zwracana wartość wywołania zwrotnego filtru testu trafienia to HitTestFilterBehavior, który określa, jakiego typu akcję należy podjąć podczas przetwarzania drzewa wizualnego na potrzeby testowania trafień. Jeśli na przykład wywołanie zwrotne filtru testów trafień zwróci wartość ContinueSkipSelfAndChildren, możesz usunąć bieżący obiekt wizualizacji i jego elementy podrzędne z oceny wyników testu trafienia.

Note

Oczyszczanie drzewa wizualnego obiektów zmniejsza ilość przetwarzania wymaganego podczas oceny wyników testu trafienia.

Oczyszczanie drzewa wizualnego przy użyciu filtru testu trafienia
Przycinanie drzewa wizualnego

Dotyczy