Function: awline

Syntax

awline ({<cursor>})

Type

string

Returns

The text line at a screen position indicated by an interactive mouse operation. Only text in an alpha window may be indicated. If the line is partially obscured by other windows, or is clipped out, the whole line will still be returned. If no text is found at the position, an empty string is returned.

Parameters

• <cursor>
  The cursor to use during the mouse operation. If omitted, the small crosshairs is used.

Examples

Use the default cursor.

string text = awline

Use a "hand" cursor.

string text = awline(hand)

See Also