Поделиться через


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

Определение

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

public enum class HitTestFilterBehavior
public enum HitTestFilterBehavior
type HitTestFilterBehavior = 
Public Enum HitTestFilterBehavior
Наследование
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, можно удалить текущий визуальный объект и его потомки из оценки результатов теста нажатия.

Примечание

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

Обрезка визуального дерева с помощью фильтра проверки попадания
Обрезка визуального дерева

Применяется к