Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

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
Not applicable.

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 Server 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 Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.