


curs_slk(3X)                                         curs_slk(3X)


NNAAMMEE
       ccuurrss__ssllkk: ssllkk__iinniitt, ssllkk__sseett, ssllkk__rreeffrreesshh, ssllkk__nnoouuttrreeffrreesshh,
       ssllkk__llaabbeell, ssllkk__cclleeaarr, ssllkk__rreessttoorree, ssllkk__ttoouucchh,  ssllkk__aattttrroonn,
       ssllkk__aattttrrsseett, ssllkk__aattttrrooffff - ccuurrsseess soft label routines

SSYYNNOOPPSSIISS
       ##iinncclluuddee <<ccuurrsseess..hh>>

       iinntt ssllkk__iinniitt((iinntt ffmmtt));;
       iinntt ssllkk__sseett((iinntt llaabbnnuumm,, cchhaarr **ccoonnsstt llaabbeell,, iinntt ffmmtt));;
       iinntt ssllkk__rreeffrreesshh((vvooiidd));;
       iinntt ssllkk__nnoouuttrreeffrreesshh((vvooiidd));;
       cchhaarr **ssllkk__llaabbeell((iinntt llaabbnnuumm));;
       iinntt ssllkk__cclleeaarr((vvooiidd));;
       iinntt ssllkk__rreessttoorree((vvooiidd));;
       iinntt ssllkk__ttoouucchh((vvooiidd));;
       iinntt ssllkk__aattttrroonn((aattttrr__tt aattttrrss));;
       iinntt ssllkk__aattttrrsseett((aattttrr__tt aattttrrss));;
       iinntt ssllkk__aattttrrooffff((aattttrr__tt aattttrrss));;

DDEESSCCRRIIPPTTIIOONN
       The slk* functions manipulate the set of soft function-key
       labels that exist on many terminals.  For those  terminals
       that do not have soft labels, ccuurrsseess takes over the bottom
       line of ssttddssccrr, reducing the size of ssttddssccrr and the  vari-
       able  LLIINNEESS.  ccuurrsseess standardizes on eight labels of up to
       eight characters each.

       The ssllkk__iinniitt routine must  be  called  before  iinniittssccrr  or
       nneewwtteerrmm is called.  If iinniittssccrr eventually uses a line from
       ssttddssccrr to emulate the soft labels, then _f_m_t determines how
       the  labels  are arranged on the screen.  Setting _f_m_t to 00
       indicates a 3-2-3 arrangement of the labels; 11 indicates a
       4-4 arrangement.

       The  ssllkk__sseett routine requires _l_a_b_n_u_m to be a label number,
       from 11 to 88; _l_a_b_e_l must be the string to  be  put  on  the
       label, up to eight characters in length.  A null string or
       a null pointer sets up a blank label.  _f_m_t is either 00, 11,
       or  22,  indicating  whether  the  label  is  to  be  left-
       justified,  centered,  or  right-justified,  respectively,
       within the label.

       The ssllkk__rreeffrreesshh and ssllkk__nnoouuttrreeffrreesshh routines correspond to
       the wwrreeffrreesshh and wwnnoouuttrreeffrreesshh routines.

       The ssllkk__llaabbeell routine returns the current label for  label
       number  _l_a_b_n_u_m, with leading and trailing blanks stripped.

       The ssllkk__cclleeaarr routine clears  the  soft  labels  from  the
       screen.

       The  ssllkk__rreessttoorree  routine, restores the soft labels to the
       screen after a ssllkk__cclleeaarr has been performed.



                                                                1





curs_slk(3X)                                         curs_slk(3X)


       The ssllkk__ttoouucchh routine forces all the  soft  labels  to  be
       output the next time a ssllkk__nnoouuttrreeffrreesshh is performed.

       The  ssllkk__aattttrroonn, ssllkk__aattttrrsseett and ssllkk__aattttrrooffff routines cor-
       respond to aattttrroonn, aattttrrsseett, and  aattttrrooffff.   They  have  an
       effect  only  if  soft  labels are simulated on the bottom
       line of the screen.  The default highlight for  soft  keys
       is A_STANDOUT (as in System V curses, which does not docu-
       ment this fact).

RREETTUURRNN VVAALLUUEE
       These routines return EERRRR upon failure and OK (SVr4 speci-
       fies only "an integer value other than EERRRR") upon success-
       ful completion.

       ssllkk__llaabbeell returns NNUULLLL on error.

NNOOTTEESS
       Most applications would use ssllkk__nnoouuttrreeffrreesshh because a wwrree--
       ffrreesshh is likely to follow soon.

PPOORRTTAABBIILLIITTYY
       The  XSI  Curses  standard, Issue 4, describes these func-
       tions.  It changes the argument  type  of  the  attribute-
       manipulation     functions     ssllkk__aattttrroonn,    ssllkk__aattttrrooffff,
       ssllkk__aattttrrsseett to be aattttrr__tt, and adds ccoonnsstt qualifiers.

SSEEEE AALLSSOO
       ccuurrsseess(3X),        ccuurrss__aattttrr(3X),        ccuurrss__iinniittssccrr(3X),
       ccuurrss__rreeffrreesshh(3X)



























                                                                2


