HitTestFilterBehavior Перечисление

Определение

Пространство имен:

System.Windows.Media

Сборка:

PresentationCore.dll

Задает поведение возврата проверки нажатия в методе обратного вызова фильтра проверки нажатия.

public enum class HitTestFilterBehavior

public enum HitTestFilterBehavior

type HitTestFilterBehavior = 

Public Enum HitTestFilterBehavior

Наследование

Object

ValueType

Enum

HitTestFilterBehavior

Поля

Continue	6	Выполнять проверку нажатия для текущего Visual и для его потомков.
ContinueSkipChildren	2	Проверять нажатие для текущего Visual, но не для его потомков.
ContinueSkipSelf	4	Не проверять нажатие для текущего Visual, но проверять нажатие для его потомков.
ContinueSkipSelfAndChildren	0	Не проверять нажатие для текущего Visual или его потомков.
Stop	8	Остановить проверку нажатия в текущем Visual.

Примеры

В следующем примере показано, как вернуть HitTestFilterBehavior значение из метода обратного вызова фильтра проверки попадания. В этом случае фильтр пропускает метки и их потомки и проверяет все остальные нажатия.

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

Комментарии

Возвращаемым значением обратного вызова фильтра проверки попадания HitTestFilterBehaviorявляется , который определяет, какой тип действия следует предпринять при обработке визуального дерева для проверки попадания. Например, если обратный вызов фильтра проверки нажатия возвращает значение ContinueSkipSelfAndChildren, можно удалить текущий визуальный объект и его потомки из оценки результатов теста нажатия.

Примечание

Удаление визуального дерева объектов уменьшает объем обработки, необходимый во время оценки результатов проверки попадания.

Обрезка визуального дерева