Functions | |
HC_KEY | Insert_String_Cursor (HC_KEY text_key, int row, int column) |
HC_KEY Insert_String_Cursor | ( | HC_KEY | text_key, | |
int | row, | |||
int | column | |||
) |
Places a cursor into a text string.
text_key | - Identifier returned by a previous call to Insert_Text() or Insert_Text_With_Encoding(). | |
row | - The row number in which the cursor should be initially stationed. For now, this should always be specified as zero. | |
column | - The column offset at which the cursor should be initially stationed. The first columnis at offset zero. |
A string cursor will be moved by a scroll, but is normally unmoved and unaffected by any Edit. String cursors are commonly used to echo user string input automatically.
Only the key-returning form of the Insert is provided since cursors are not very useful without a means of changing them.
If the row or column position specified is not within the bounds of the text an error is generated.