A text cursor (TTextCursor
) is a rectangular
area of a single colour which can optionally be set to flash. It has a height,
width, ascent and origin, illustrated below.
The text cursor is positioned on screen by specifying an offset
between its origin and the origin of a window. It can be added to a window
group using RWindowGroup::SetTextCursor()
.
Two predefined types of text cursors are provided: solid and hollow rectangles. In addition, from v7.0s, bitmaps may be
used as text cursors. Custom text cursors are added to the window server using RWsSession::SetCustomTextCursor()
. They have a unique identifier, which is used by RWindowGroup::SetTextCursor()
. They are clipped if too large and their vertical alignment can be adjusted.