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

Определение

Задает поведение возврата проверки нажатия в методе обратного вызова фильтра проверки нажатия.Specifies the return behavior of a hit test in a hit test filter callback method.

public enum class HitTestFilterBehavior
public enum HitTestFilterBehavior
type HitTestFilterBehavior = 
Public Enum HitTestFilterBehavior
Наследование
HitTestFilterBehavior

Поля

Continue 6

Выполнять проверку нажатия для текущего Visual и для его потомков.Hit test against the current Visual and its descendants.

ContinueSkipChildren 2

Проверять нажатие для текущего Visual, но не для его потомков.Hit test against the current Visual, but not its descendants.

ContinueSkipSelf 4

Не проверять нажатие для текущего Visual, но проверять нажатие для его потомков.Do not hit test against the current Visual, but hit test against its descendants.

ContinueSkipSelfAndChildren 0

Не проверять нажатие для текущего Visual или его потомков.Do not hit test against the current Visual or its descendants.

Stop 8

Остановить проверку нажатия в текущем Visual.Stop hit testing at the current Visual.

Примеры

В следующем примере показано, как вернуть HitTestFilterBehavior значение из метода обратного вызова фильтра проверки попадания.The following example shows how to return a HitTestFilterBehavior value from a hit test filter callback method. В этом случае фильтр пропускает метки и их потомков и проверяет все остальное.In this case, the filter skips labels and their descendants and hit tests everything else.

// 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 , определяющий тип действия, которое должно выполняться при обработке визуального дерева для проверки нажатия.The return value of the hit test filter callback is a HitTestFilterBehavior, which determines what type of action should be taken when processing the visual tree for hit testing. Например, если обратный вызов фильтра проверки попадания возвращает значение ContinueSkipSelfAndChildren , можно удалить текущий визуальный объект и его потомков из оценки результатов проверки попадания.For example, if your hit test filter callback returns the value ContinueSkipSelfAndChildren, you can remove the current visual object and its descendants from the hit test results evaluation.

Примечание

При очистке визуального дерева объектов уменьшается объем обработки, необходимый во время оценки результатов проверки попадания.Pruning the visual tree of objects decreases the amount of processing that is required during the hit test results evaluation pass.

Обрезка визуального дерева с помощью фильтра проверки попаданияPruning a visual tree using a hit test filter
Обрезка визуального дереваPruning a visual tree

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