<< Click to display table of contents >> TCustomRichView.GetItemAt

Returns item at the position X,Y.

function GetItemAt(X, Y: TRVCoord;

  out RVData: TCustomRVFormattedData;

  out ItemNo, OffsetInItem: Integer; Strict: Boolean): Boolean;

 

Input parameters:

X,Y – coordinates relative to the top level corner of document (scrollable area)

Strict:

▪True – the method returns an item which is exactly at the specified location;

▪False – the method returns a position where caret should be moved, if the user would click the mouse at (X,Y)

 

Output parameters:

RVData – object containing this item (RichView.RVData or table cell or RVData of cell inplace editor)

ItemNo – index of item (in the items list of RVData), or -1 if no item was found.

OffsetInItem – position of this item:

▪for non-text: 0 (closer to the beginning of the item) or 1 (to the end);

▪for text: position is before the OffsetInItem-th character of text; characters are indexed from 1, the last position is Length(text)+1.

 

Return value:

"item found?"

 

This method must be called only when the document is formatted.

 

See also:

▪GetWordAt.

See also events:

▪OnRVMouseDown (contains example);

▪OnRVMouseUp.

Demo projects:

▪Demos\*\Assorted\PlanetQuiz\