VisualTreeHelper::HitTest Method (Visual^, HitTestFilterCallback^, HitTestResultCallback^, HitTestParameters^)

 

Initiates a hit test on the specified Visual, with caller-defined HitTestFilterCallback and HitTestResultCallback methods.

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

public:
static void HitTest(
	Visual^ reference,
	HitTestFilterCallback^ filterCallback,
	HitTestResultCallback^ resultCallback,
	HitTestParameters^ hitTestParameters
)

Parameters

reference
Type: System.Windows.Media::Visual^

The Visual to hit test.

filterCallback
Type: System.Windows.Media::HitTestFilterCallback^

The method that represents the hit test filter callback value.

resultCallback
Type: System.Windows.Media::HitTestResultCallback^

The method that represents the hit test result callback value.

hitTestParameters
Type: System.Windows.Media::HitTestParameters^

The parameter value to hit test against.

The filterCallback parameter can be null, in which case it is ignored. If filterCallback is not null, it is invoked before resultCallback. resultCallback cannot be null.

System_CAPS_noteNote

It is possible for a hit test that starts in a 2D visual tree to return RayHitTestResult, which is a 3D hit test result object. Hit testing that starts in a 2D visual tree seamlessly extends into any defined 3D visual tree.

The following example shows how to use the HitTest method to hit test the objects within a Canvas.

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

.NET Framework
Available since 3.0
Return to top
Show: