Udostępnij za pośrednictwem


HitTestFilterBehavior Wyliczenie

Definicja

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

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

Pola

Continue 6

Test trafienia względem prądu Visual i jego elementów potomnych.

ContinueSkipChildren 2

Test trafienia względem bieżącego Visualelementu , ale nie jego elementów potomnych.

ContinueSkipSelf 4

Nie uderzaj w test w stosunku do bieżącego Visualelementu , ale przetestuj względem jego elementów potomnych.

ContinueSkipSelfAndChildren 0

Nie uderzaj w test względem prądu Visual lub jego elementów potomnych.

Stop 8

Zatrzymaj testowanie trafień w bieżącym pliku Visual.

Przykłady

W poniższym przykładzie pokazano, jak zwrócić HitTestFilterBehavior wartość z metody wywołania zwrotnego filtru 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 trafienia zwróci wartość ContinueSkipSelfAndChildren, możesz usunąć bieżący obiekt wizualny i jego elementy podrzędne z oceny wyników testu trafienia.

Uwaga

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
Oczyszczanie drzewa wizualnego

Dotyczy