HC_Insert_String_Cursor

Key HC_Insert_String_Cursor(Key text_key, int row, int column)
Key HC_Insert_String_Cursor(Key text_key, int row, int column)

Places a cursor into a text string.

A cursor suitable for marking a position in a text string is generated on the screen. The cursor_key should be saved and may be used later in calls to Move_String_Cursor() or Enable_String_Events() .

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.

The cursor is firmly attached to the original text; if the text primitive is deleted, the cursor will be also.

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.

HC_Enable_String_Events, HC_Move_String_Cursor, HC_Show_String_Cursor, HC_Insert_Text, HC_Insert_Text_With_Encoding, HC_Scroll_Text()

Parameters

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.

Returns

cursor_key