HitTestFilterBehavior Enumeration


Specifies the return behavior of a hit test in a hit test filter callback method.

Namespace:   System.Windows.Media
Assembly:  PresentationCore (in PresentationCore.dll)

public enum class HitTestFilterBehavior

Member nameDescription

Hit test against the current Visual and its descendants.


Hit test against the current Visual, but not its descendants.


Do not hit test against the current Visual, but hit test against its descendants.


Do not hit test against the current Visual or its descendants.


Stop hit testing at the current Visual.

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. For example, if your hit test filter callback return 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

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.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 3.0
Return to top