NAME    [Toc]    [Back]

       curs_border_set,    border_set,    wborder_set,   box_set,
       hline_set,    whline_set,    mvhline_set,    mvwhline_set,
       vline_set,  wvline_set,  mvvline_set,  mvwvline_set - Draw
       borders or lines by using complex  characters  and  renditions

SYNOPSIS    [Toc]    [Back]

       #include <curses.h>

       int border_set(
               const cchar_t *ls,
               const cchar_t *rs,
               const cchar_t *ts,
               const cchar_t *bs,
               const cchar_t *tl,
               const cchar_t *tr,
               const cchar_t *bl,
               const cchar_t *br ); int wborder_set(
               WINDOW *win,
               const cchar_t *ls,
               const cchar_t *rs,
               const cchar_t *ts,
               const cchar_t *bs,
               const cchar_t *tl,
               const cchar_t *tr,
               const cchar_t *bl,
               const cchar_t *br ); int box_set(
               WINDOW *win,
               const cchar_t *verch,
               const cchar_t *horch ); int hline_set(
               const cchar_t *wch,
               int n ); int whline_set(
               WINDOW *win,
               const cchar_t *wch,
               int n ); int mvhline_set(
               int y,
               int x,
               const cchar_t *wch,
               int n ); int mvwhline_set(
               WINDOW *win,
               int y,
               int x,
               const cchar_t *wch,
               int n ); int vline_set(
               const cchar_t *wch,
               int n ); int wvline_set(
               WINDOW *win,
               const cchar_t *wch,
               int n ); int mvvline_set(
               int y,
               int x,
               const cchar_t *wch,
               int n ); int mvwvline_set(
               WINDOW *win,
               int y,
               int x,
               const cchar_t *wch,
               int n );

LIBRARY    [Toc]    [Back]

       Curses Library (libcurses)

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       border_set, wborder_set, box_set,  hline_set,  whline_set,
       mvhline_set,    mvwhline_set,    vline_set,    wvline_set,
       mvvline_set, mvwvline_set:  XCURSES4.2

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

DESCRIPTION    [Toc]    [Back]

       The  border_set  and  wborder_set  functions draw a border
       around the edges  of  the  current  or  specified  window.
       These functions do not advance the cursor position, do not
       perform special character processing, and do  not  perform
       wrapping.

       The  arguments  in  the  left-hand column of the following
       table contain spacing complex characters with  renditions,
       which have the specified uses in drawing the border:

       ----------------------------------------------------------------
       Argument Name   Usage                             Default Value
       ----------------------------------------------------------------
       ls              Starting-column side              WACS_VLINE
       rs              Ending-column side                WACS_VLINE
       ts              First-line side                   WACS_HLINE
       bs              Last-line side                    WACS_HLINE
       tl              Corner  of  the  first line and   WACS_ULCORNER
                       the starting column
       tr              Corner of the  first  line  and   WACS_URCORNER
                       the ending column
       bl              Corner of the last line and the   WACS_LLCORNER
                       starting column
       br              Corner of the last line and the   WACS_LRCORNER
                       ending column
       ----------------------------------------------------------------

       If  the  value  of any argument in the left-hand column of
       the table is a null pointer, then the default value in the
       right-hand column is used. If the value of any argument in
       the left-hand column of the table is a multicolumn character,
 the results are undefined.

       The  box_set  function  draws a border around the edges of
       the specified window. This function does not  advance  the
       cursor  position,  does not perform special-character processing,
 and does not perform wrapping.

       The call box_set(win, verch, horch); is equivalent to  the
       following call:

       wborder_set(win, verch, verch,
           horch, horch, NULL, NULL, NULL, NULL);

       The *line_set functions use wch to draw a line in the current
 or specified window, starting at the current or specified
  position. The line is at most n positions in length
       or as many positions as can fit  into  the  window.  These
       functions  do not advance the cursor position, do not perform
 special-character  processing,  and  do  not  perform
       wrapping.

       The  hline_set,  mvhline_set, mvwhline_set, and whline_set
       functions draw a line proceeding toward the last column of
       the same line.

       The  vline_set,  mvvline_set, mvwvline_set, and wvline_set
       functions draw a line proceeding toward the last  line  of
       the window.

NOTES    [Toc]    [Back]

       The  header  file  <curses.h>  automatically  includes the
       header file <stdio.h>.

       Note    that    border_set,    hlines_set,    mvhline_set,
       mvvline_set, mvwhline_set, mvwvline_set, and vline_set may
       be macros.

RETURN VALUES    [Toc]    [Back]

       Upon successful completion,  these  functions  return  OK.
       Otherwise, they return ERR.

SEE ALSO    [Toc]    [Back]

       Functions: curses(3), curs_border(3), curs_outopts(3)

       Others: standards(5)



                                               curs_border_set(3)