X/Open Curses Library Functions              borderset(3XCURSES)



NAME
     borderset, boxset, wborderset -  use  complex  characters
     (and renditions) to draw borders

SYNOPSIS
     cc [ flag... ] file... -I /usr/xpg4/include  -L  /usr/xpg4/lib \
      -R  /usr/xpg4/lib  -lcurses  [ library... ]

     c89 [ flag... ] file... -lcurses [ library... ]

     #include 

     int borderset(const cchart *ls, const cchart *rs, const cchart *ts,
          const cchart *bs, const cchart *tl, const cchart *tr,
          const cchart *bl,const cchart *br);


     int wborderset(WINDOW *win, const cchart *ls, const cchart *rs,
          const cchart *ts,const cchart *bs, const cchart *tl,
          const cchart *tr, const cchart *bl,const cchart *br);


     int boxset(WINDOW *win, const cchart *verch, const cchart *horch);


DESCRIPTION
     The borderset() and wborderset() functions draw  a  border
     around the specified window.  All parameters must be spacing
     complex characters with renditions. A parameter which  is  a
     null pointer is replaced by the default character.


     Constant Values for Borders






















SunOS 5.11           Last change: 5 Jun 2002                    1






X/Open Curses Library Functions              borderset(3XCURSES)



     
     Constant Values for Borders                                           
    
              Parameter             Default Constant     Default Character 
    
               verch                   WACSVLINE                         
               horch                   WACSHLINE                -         
                 ls                    WACSVLINE                         
                 rs                    WACSVLINE                         
                 ts                    WACSHLINE                -         
                 bs                    WACSHLINE                -         
                 bl                  WACSBLCORNER               ]         
                 br                  WACSBRCORNER               ]         
                 tl                  WACSULCORNER               ]         
                 tr                  WACSURCORNER               ]         
    



     The call

       boxset(win,
       verch, horch)



     is a short form for

       wborder(win,
       verch, verch,
       horch, horch, NUL,
       NUL, NUL, NUL)



     When the window is boxed, the bottom and top rows and  right
     and left columns  are unavailable for text.

PARAMETERS
     ls       Is the character and rendition used  for  the  left
              side of the border.


     rs       Is the character and rendition used for  the  right
              side of the border.


     ts       Is the character and rendition used for the top  of
              the border.






SunOS 5.11           Last change: 5 Jun 2002                    2






X/Open Curses Library Functions              borderset(3XCURSES)



     bs       Is the character and rendition used for the  bottom
              of the border.


     tl       Is the character and rendition used  for  the  top-
              left corner of the border.


     tr       Is the character and rendition used  for  the  top-
              right corner of the border.


     bl       Is  the  character  and  rendition  used  for   the
              bottom-left corner of the border.


     br       Is  the  character  and  rendition  used  for   the
              bottom-right corner of the border.


     win      Is the pointer to the window in which the border or
              box is to be drawn.


     verch    Is the character and rendition used  for  the  left
              and right columns of the box.


     horch    Is the character and rendition used for the top and
              bottom rows of the box.


RETURN VALUES
     On success,  these  functions  return  OK.  Otherwise,  they
     return ER.

ERORS
     None.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:













SunOS 5.11           Last change: 5 Jun 2002                    3






X/Open Curses Library Functions              borderset(3XCURSES)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     addwch(3XCURSES),   addch(3XCURSES),    attrget(3XCURSES),
     attroff(3XCURSES),   border(3XCURSES),  libcurses(3XCURSES),
     attributes(5), standards(5)










































SunOS 5.11           Last change: 5 Jun 2002                    4