X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_slk.3x.html;h=bb6758c1eed7166d07a0b1801da6d1cca892aa2a;hb=ce4803687b821efbc5fb2c5a5f06d69cd4dc2656;hp=0fa3049ed3813aec39ddad3c16dffdf526231264;hpb=f9d358b4f3cf9b44727a0ee5c08f8ca6ae4e3821;p=ncurses.git diff --git a/doc/html/man/curs_slk.3x.html b/doc/html/man/curs_slk.3x.html index 0fa3049e..bb6758c1 100644 --- a/doc/html/man/curs_slk.3x.html +++ b/doc/html/man/curs_slk.3x.html @@ -1,7 +1,6 @@ - +
+ +- curs_slk(3x) curs_slk(3x) --
- slk_init, slk_set, slk_refresh, slk_noutrefresh, +
+ slk_init, slk_set, slk_wset, slk_refresh, slk_noutrefresh, slk_label, slk_clear, slk_restore, slk_touch, slk_attron, slk_attrset, slk_attroff, slk_attr_on, slk_attr_set, slk_attr_off, slk_attr, slk_color - curses soft label routines --
+
#include <curses.h> int slk_init(int fmt); @@ -71,28 +69,28 @@ int slk_attrset(const chtype attrs); int slk_attr_on(attr_t attrs, void* opts); int slk_attr_off(const attr_t attrs, void * opts); - int slk_attr_set(const attr_t attrs, - short color_pair_number, void* opts); + int slk_attr_set(const attr_t attrs, short color_pair, + void* opts); attr_t slk_attr(void); - int slk_color(short color_pair_number); + int slk_color(short color_pair); + int slk_wset(int labnum, const wchar_t *label, int fmt); --
+
The slk* functions manipulate the set of soft function-key - labels that exist on many terminals. For those terminals + 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 vari- - able LINES. curses standardizes on eight labels of up to - eight characters each. In addition to this, the ncurses - implementation supports a mode where it simulates 12 la- - bels of up to five characters each. This is useful for - today's PC-like enduser devices. ncurses simulates this - mode by taking over up to two lines at the bottom of the - screen; it does not try to use any hardware support for + line of stdscr, reducing the size of stdscr and the vari- + able LINES. curses standardizes on eight labels of up to + eight characters each. In addition to this, the ncurses + implementation supports a mode where it simulates 12 la- + bels of up to five characters each. This is useful for + today's PC-like enduser devices. ncurses simulates this + mode by taking over up to two lines at the bottom of the + screen; it does not try to use any hardware support for this mode. - The slk_init routine must be called before initscr or + The slk_init routine must be called before initscr or newterm is called. If initscr eventually uses a line from stdscr to emulate the soft labels, then fmt determines how the labels are arranged on the screen: @@ -104,10 +102,11 @@ 2 indicates the PC-like 4-4-4 mode. 3 is again the PC-like 4-4-4 mode, but in addition - an index line is generated, helping the user to + an index line is generated, helping the user to identify the key numbers easily. - The slk_set routine has three parameters: + The slk_set routine (and the slk_wset routine for the + wide-character library) has three parameters: labnum is the label number, from 1 to 8 (12 for fmt @@ -151,8 +150,7 @@ line of the screen. --
+
These routines return ERR upon failure and OK (SVr4 speci- fies only "an integer value other than ERR") upon success- ful completion. @@ -199,35 +197,38 @@ be allocated. --
+
Most applications would use slk_noutrefresh because a wre- fresh is likely to follow soon. --
+
The XSI Curses standard, Issue 4, describes these func- tions. It changes the argument type of the attribute-ma- nipulation functions slk_attron, slk_attroff, slk_attrset to be attr_t, and adds const qualifiers. The format codes - 2 and 3 for slk_init() and the function slk_attr are spe- - cific to ncurses. + 2 and 3 for slk_init and the function slk_attr are specif- + ic to ncurses. --
+
curses(3x), curs_attr(3x), curs_initscr(3x), curs_re- - fresh(3x) + fresh(3x), curs_variables(3x). curs_slk(3x)-