Programming Guide



sm_home

Homes the cursor

int sm_home(void);

Returns

Description

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.

See Also

sm_backtab, sm_gofield, sm_last, sm_nl, sm_tab