GetItemRect Function (ListViewEx)

Class

ListViewEx.

Action

Returns the size and position of the item relative to the listview.

Availability

This functionality is supported only if you are using the Open Agent.

Syntax

SizeRect = listview.GetItemRect (Item[, bIconRect, iColumn])
Variable Description
SizeRect The size and position of the item. RECT.
Item The item to find. LISTITEM.
bIconRect Optional: TRUE to return the size and position of the icon. Default returns the rectangle of the text. BOOLEAN.
iColumn Optional: The column position of the item. Default returns the whole line. INTEGER.

Notes

GetItemRect returns information about the location of a listview item. By default, GetItemRect returns the rectangle for the text of the item. The rectangle returned includes the item’s X and Y position relative to the listview, its width, and its height.

Optional: the return value can specify the location and size of the item’s icon instead. If the item is currently scrolled out of view, the returned coordinates will reflect this. For example, if item 1 is specified, and the top item visible is item 10, then the Y coordinate returned is a negative number.

Example

RECT rect
rect = TestApplication.ListViewDialog.TheListView.GetItemRect("item to capture", TRUE)
TestApplication.ListViewDialog.CaptureBitmap(rect.xPos, rect.yPos, rect.xSize, rect.ySize)