Programming Guide |
Homes the cursor
int sm_home(void);
- 1 The number of the field where the cursor is put.
- 0 All fields on the screen are tab-protected and the home position is not in a protected field.
sm_home
moves the cursor to the first enterable position of the first tab-accessible field on the current screen. Panther automatically calls this function when it processes the logical key HOME.The first enterable position in a field depends on the justification of the field and, in fields with embedded characters, on the presence of punctuation. If all the screen's fields are tab-protected,
sm_home
moves the cursor to the first line and column (0,0) of the screen. If a tab-protected field occupies this position, Panther places the cursor in that field; in this case, the cursor might be invisible.
sm_home
does not immediately trigger field entry, exit, or validation processing. Processing is based on the cursor position when control returns to sm_input.
sm_backtab, sm_gofield, sm_last, sm_nl, sm_tab