Export (0) Print
Expand All
Expand Minimize

HitTestFilterCallback Delegate

Represents the callback method that specifies parts of the visual tree to omit from hit test processing

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

'Declaration
Public Delegate Function HitTestFilterCallback ( _
	potentialHitTestTarget As DependencyObject _
) As HitTestFilterBehavior

Parameters

potentialHitTestTarget
Type: System.Windows.DependencyObject
The visual to hit test.

Return Value

Type: System.Windows.Media.HitTestFilterBehavior
A HitTestFilterBehavior that represents the action resulting from the hit test.

The hit test filter callback method is invoked for all the visual objects that map to the hit test criteria, starting from the visual you specify and descending through its branch of the visual tree. However, you may want to ignore certain branches of the visual tree that you are not interested in processing in your hit test results callback function. The return value of the hit test filter callback function determines what type of action the enumeration of the visual objects should take. For example, if you return the value, ContinueSkipSelfAndChildren, you can remove the current visual object and its descendants from the hit test results enumeration. This means that the hit test results callback method will not see these objects in its enumeration.

NoteNote

Pruning the visual tree of objects decreases the amount of processing during the hit test results enumeration pass.

Pruning a visual tree

Pruning a visual tree using a hit test filter

The following example shows how to invoke HitTest by using a HitTestFilterCallback value. The corresponding hit test callback method is also defined.


		' Respond to the mouse wheel event by setting up a hit test filter and results enumeration.
		Private Overloads Sub OnMouseWheel(ByVal sender As Object, ByVal e As MouseWheelEventArgs)
			' Retrieve the coordinate of the mouse position.
			Dim pt As Point = e.GetPosition(CType(sender, UIElement))

			' Clear the contents of the list used for hit test results.
			hitResultsList.Clear()

			' Set up a callback to receive the hit test result enumeration.
			VisualTreeHelper.HitTest(myCanvas, New HitTestFilterCallback(AddressOf MyHitTestFilter), New HitTestResultCallback(AddressOf MyHitTestResult), New PointHitTestParameters(pt))

			' Perform actions on the hit test results list.
			If hitResultsList.Count > 0 Then
				ProcessHitTestResultsList()
			End If
		End Sub


The following example shows how to return a HitTestFilterBehavior value from a hit test filter callback method.


		' 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


.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Community Additions

ADD
Show:
© 2014 Microsoft