HP-UX Reference (11i v2 07/12) - 3 Library Functions N-Z (vol 7)

slk_attroff(3X) slk_attroff(3X)

(ENHANCED CURSES)

The slk_touch() function forces all the soft labels to be output the next time

slk_noutrefresh()

or slk_refresh()

is called.

The

slk_attron() , slk_attrset()

and slk_attroff()

functions correspond to attron(),

attrset(), and attroff() . They have an effect only if soft labels are simulated on the bottom line of

the screen.

The slk_attr_off()

, slk_attr_on()

, slk_attr_set()

and slk_color() functions

correspond to

attr_off() , attr_on(), attr_set()

and color_set() , respectively and thus

support the attribute constants with the WA_ preﬁx and color.

RETURN VALUE

Upon successful completion,

slk_label() returns the requested label with leading and trailing blanks

stripped. Otherwise, it returns a null pointer.

Upon successful completion, the other functions return OK. Otherwise, they return ERR.

ERRORS

No errors are deﬁned.

APPLICATION USAGE

When using multi-byte character sets, applications should check the width of the string by calling

mbstowcs() and then wcswidth() before calling slk_set(). When using wide characters, applica-

tions should check the width of the string by calling wcswidth() before calling slk_set().

Since the number of columns that a wide character string will occupy is codeset-speciﬁc, call

wcwidth()

and wcswidth() to check the number of column positions in the string before calling slk_wset().

Most applications would use

slk_noutrefresh()

because a wrefresh() is likely to follow soon.