This documentation is archived and is not being maintained.

ListBox.GetItemRectangle Method

Returns the bounding rectangle for an item in the ListBox.

[Visual Basic]
Public Function GetItemRectangle( _
   ByVal index As Integer _
) As Rectangle
[C#]
public Rectangle GetItemRectangle(
 int index
);
[C++]
public: Rectangle GetItemRectangle(
 int index
);
[JScript]
public function GetItemRectangle(
   index : int
) : Rectangle;

Parameters

index
The zero-based index of item whose bounding rectangle you want to return.

Return Value

A Rectangle that represents the bounding rectangle for the specified item.

Exceptions

Exception Type Condition
ArgumentOutOfRangeException The index parameter is less than zero or greater than or equal to the value of the Count property of the ListBox.ObjectCollection class.

Remarks

If the item specified in the index parameter is not visible, the rectangle returned by this method will be outside the visible portion of the control. You can use this method to determine the size and position of an item within the list. To get the height of an item, especially a variable-height owner drawn list item, you can use the GetItemHeight method.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

ListBox Class | ListBox Members | System.Windows.Forms Namespace

Show: