SAS Component Language Dictionary

SETCR

Controls the cursor's response to the carriage-return key

Category:

Control or Field

Syntax
Details
Example
See Also

Syntax

CALL SETCR(advance,return<,modify>);

advance

specifies how the cursor moves when a user presses the carriage-return key:

'STAY': The cursor does not move.
'HTAB': The cursor moves to the next field in the same row. This option makes the carriage-return key work like a horizontal tab key. When the last field in the current row is reached, the cursor moves to the first field in the next row.
'NEWL': The cursor moves to the first field in the next line. This option makes the carriage-return key work like a new-line key. When the last line is reached, the cursor moves to the first field in the first line.
'VTAB': The cursor moves to the first field in the next line in the current column. This option makes the carriage-return key work like a vertical tab key. When the last field in the current column is reached, the cursor moves to the top of the next column.
'HOME': The cursor moves to the command line, or to the first field in the window if the window has no command line.

Type: Character

return

specifies whether a carriage return passes control back to the application:

'RETURN': A carriage return passes control to the application, whether or not a field is modified. That is, the MAIN section of an SCL program is executed.
'NORETURN': A carriage return does not pass control to the application unless a field is modified.

Type: Character

modify

specifies whether the field should be marked as modified:

'MODIFY': A carriage return on a field is considered a modification of the field unless the field is protected.
'NOMODIFY': A carriage return on a field is not considered a modification of the field.

Type: Character

Details

SETCR works like a more powerful version of CONTROL ENTER for defining the behavior of the carriage-return key. This routine overrides the ENTER or NOENTER option of the CONTROL statement.

FRAME entries ignore SETCR.

Example

Move the cursor vertically to the first field in the next line in the current column when the user presses the carriage-return key. Control does not pass to the application, and the field is not modified by a carriage return.

call setcr('vtab','noreturn','nomodify');