Export (0) Print
Expand All
Expand Minimize

AccessibleObject.HitTest Method

Retrieves the child object at the specified screen coordinates.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public virtual AccessibleObject HitTest (
	int x,
	int y
)
public AccessibleObject HitTest (
	int x, 
	int y
)
public function HitTest (
	x : int, 
	y : int
) : AccessibleObject

Parameters

x

The horizontal screen coordinate.

y

The vertical screen coordinate.

Return Value

An AccessibleObject that represents the child object at the given screen coordinates. This method returns the calling object if the object itself is at the location specified. Returns a null reference (Nothing in Visual Basic) if no object is at the tested location.

Exception typeCondition

COMException

The control cannot be hit tested.

For nonrectangular objects such as list view items, the coordinates of the object's bounding rectangle retrieved by Bounds can fail if tested with HitTest, because HitTest determines the object's boundaries on a pixel-by-pixel basis.

Notes to Inheritors All visual objects must support this method; sound objects do not support it.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft