Прочитать на английском

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


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

Определение

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

C#
public enum HitTestFilterBehavior
Наследование
HitTestFilterBehavior

Поля

Имя Значение Описание
Continue 6

Выполнять проверку нажатия для текущего Visual и для его потомков.

ContinueSkipChildren 2

Проверять нажатие для текущего Visual, но не для его потомков.

ContinueSkipSelf 4

Не проверять нажатие для текущего Visual, но проверять нажатие для его потомков.

ContinueSkipSelfAndChildren 0

Не проверять нажатие для текущего Visual или его потомков.

Stop 8

Остановить проверку нажатия в текущем Visual.

Примеры

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

C#
// 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;
    }
}

Комментарии

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

Примечание

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

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

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

Продукт Версии
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9