| struct TTextCursor |
Text cursor parameter information.
A text cursor is a rectangular area which can be set to flash. It is normally only visible when the window group which owns it has the keyboard focus. This structure is used to define the parameters of a text cursor, which can be selected for use through the window group using RWindowGroup::SetTextCursor().
Custom (non-rectangular) text cursors are supported from v7.0s. They are added to the window server using RWsSession::SetCustomTextCursor(), after which they can be selected for use through the window group, in the same way as standard rectangular cursors. They have a unique identifier, stored in the iType member, which must be greater than ETypeLastBasic. Custom text cursors are clipped to their iHeight and iWidth values. Their iColour member is not used.
| Public Member Enumerations | |
|---|---|
| enum | EFlags { EFlagNoFlash = 0x00000001, EFlagClipHorizontal = 0x00000002, EFlagClipVertical = 0x00000004 } |
| enum | ENamedCursors { ETypeNone, ETypeRectangle, ETypeHollowRectangle, ETypeFirst = ETypeRectangle, ETypeLast = ETypeHollowRectangle, ETypeLastBasic = 1000 } |
| Public Member Type Definitions | |
|---|---|
| typedef | TInt EType |
| Public Attributes | |
|---|---|
| TInt | iAscent |
| TRgb | iColor |
| TUint | iFlags |
| TInt | iHeight |
| TInt | iType |
| TInt | iWidth |
Cursor flash and clipping flags.
The flags not listed below are for internal use only.
| EFlagNoFlash = 0x00000001 |
The text cursor should not flash. |
| EFlagClipHorizontal = 0x00000002 |
The bitmap of each sprite member is clipped left of its x-origin and right of its x-origin plus iWidth. Used for custom text cursors only. |
| EFlagClipVertical = 0x00000004 |
The bitmap of each sprite member is clipped vertically. How it is clipped depends on the text cursor's vertical alignment, see the TCustomTextCursorAlignment enum in class RWsSession. Used for custom text cursors only. |
Cursor type values.
The values between ETypeFirst and ETypeLastBasic are reserved for predefined cursors. Custom text cursors must have a value greater than ETypeLastBasic.
The values not listed below are for internal use only.
| ETypeNone | |
| ETypeRectangle |
Standard filled rectangular cursor. |
| ETypeHollowRectangle |
Standard hollow rectangular cursor. |
| ETypeFirst = ETypeRectangle |
The first predefined cursor type. Equivalent to ETypeRectangle. This can be used for iterating through the predefined cursor types. WARNING: Enum for internal use ONLY. Compatibility is not guaranteed in future releases. |
| ETypeLast = ETypeHollowRectangle |
The last predefined cursor type. Equivalent to ETypeHollowRectangle. This can be used for iterating through the predefined cursor types. WARNING: Enum for internal use ONLY. Compatibility is not guaranteed in future releases. |
| ETypeLastBasic = 1000 |
Reserved for future use. /** All custom text cursors must have a type value greater than this. |
| TInt | iAscent |
The ascent of the text cursor (the distance between the origin and the top).
| TRgb | iColor |
The colour of the text cursor.
If the cursor is flashing, this colour is XOR'd with the screen.
This value is not used for custom text cursors.
| TUint | iFlags |
Cursor flash and clipping flags.
For possible values, see the EFlags enum.
| TInt | iHeight |
The height of the text cursor.
This value is also used for clipping custom text cursors, if the EFlagClipVertical flag is set.
| TInt | iWidth |
The width of the text cursor.
Custom text cursors are clipped to this value, if the EFlagClipHorizontal flag is set.