The Curses interface manipulates the set of soft function-key labels that exist on many terminals. For those terminals that do not have soft labels, Curses takes over the bottom line of stdscr, reducing the size of stdscr and the value of the LINES external variable. There can be up to eight labels of up to eight display columns each.
To use soft labels, slk_init() must be called before calling initscr(3XCURSES), newterm(3XCURSES), or ripoffline(3XCURSES). If initscr() eventually uses a line from stdscr to emulate the soft
labels, then fmt determines how the labels are arranged on the screen. Setting fmt to 0 indicates a 3-2-3 arrangement of the labels; 1 indicates a 4-4 arrangement.
Other values for fmt are unspecified.
The slk_init() function has the effect of calling ripoffline() to reserve one screen line to accommodate the requested format.
The slk_set() and slk_wset() functions specify the text of soft label number labnum, within the range from 1 to and including 8. The label argument is the string to be put the lable. With slk_set() and slk_wset(), the width of the label is limited to eight columns positions. A null
string or a null pointer specifies a blank label. The justify argument can have the following values to indicate how to justify label within the space reserved
for it:
- 0
- Align the start of label with the start of the space
- 1
- Center label within the space
- 2
- Align the end of label with the end of the space
The slk_refresh() and slk_noutrefresh() functions correspond to the wrefresh(3XCURSES) and wnoutrefresh(3XCURSES) functions.
The slk_label() function obtains soft label number labnum.
The slk_clear() function immediately clears the soft labels from the screen.
The slk_restore() function immediately restores the soft labels to the screen after a call to slk_clear().
The slk_touch() function forces all the soft labels to be output the next time slk_refresh() or slk_noutrefresh() is called.
The slk_attron(), slk_attrset(), and slk_attroff() functions correspond to the attron(3XCURSES), attrset(3XCURSES),
and attroff(3XCURSES) functions. They have an effect only if soft labels are stimulated
on the bottom line of the screen.
The slk_attr_on(), slk_attr_off(), slk_attr_set() and slk_color() functions correspond to the attr_on(3XCURSES), attr_off(3XCURSES), attr_set(3XCURSES), and color_set(3XCURSES) functions. As a result, they support color and the attribute constants with the WA_ prefix.
The opts argument is reserved for definition in a future release. Currently, the opts argument is a null pointer.
|