ContainerVisual.HitTest Method

Definition

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

Return top-most visual object of a hit test.

Overloads

HitTest(Point)	Returns the top-most visual object of a hit test by specifying a Point.
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	Initiates a hit test on the ContainerVisual by using the HitTestFilterCallback and HitTestResultCallback objects.

HitTest(Point)

Returns the top-most visual object of a hit test by specifying a Point.

C#

public System.Windows.Media.HitTestResult HitTest(System.Windows.Point point);

Parameters

point

Point

The point value to hit test.

Returns

HitTestResult

The hit test result of the visual returned as a HitTestResult type.

Examples

The following example shows how to retrieve the HitTestResult return value from the HitTest method.

C#

// Capture the mouse event and hit test the coordinate point value against
// the child visual objects.
void MyVisualHost_MouseLeftButtonUp(object sender, System.Windows.Input.MouseButtonEventArgs e)
{
    // Retrieve the coordinates of the mouse button event.
    Point pt = e.GetPosition((UIElement)sender);

    // Initiate the hit test on the ContainerVisual's visual tree.
    HitTestResult result = _containerVisual.HitTest(pt);

    // Perform the action on the hit visual.
    if (result.VisualHit != null)
    {
        ProcessHitVisual((Visual)result.VisualHit);
    }
}

Remarks

The VisualHit property of the return value represents the Visual object that was hit.

HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Initiates a hit test on the ContainerVisual by using the HitTestFilterCallback and HitTestResultCallback objects.

C#

public void HitTest(System.Windows.Media.HitTestFilterCallback filterCallback, System.Windows.Media.HitTestResultCallback resultCallback, System.Windows.Media.HitTestParameters hitTestParameters);

Parameters

filterCallback

HitTestFilterCallback

The delegate that allows you to ignore parts of the visual tree that you are not interested in processing in your hit test results.

resultCallback

HitTestResultCallback

The delegate that is used to control the return of hit test information.

hitTestParameters

HitTestParameters

Defines the set of parameters for a hit test.

Remarks

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