X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fcurs_border_set.3x;fp=man%2Fcurs_border_set.3x;h=9d52ca5a1d7ba5c16412f5a8dcf1718b6b34ce13;hp=b156b77dab95a7f2153f724ff03a26edf876d373;hb=74433bcf4f6fe40862a28f3c00edaedcd5054b01;hpb=e6bb3226cdd35f5fd9f45bb1685cc2203c889480 diff --git a/man/curs_border_set.3x b/man/curs_border_set.3x index b156b77d..9d52ca5a 100644 --- a/man/curs_border_set.3x +++ b/man/curs_border_set.3x @@ -1,5 +1,5 @@ .\"*************************************************************************** -.\" Copyright 2019,2020 Thomas E. Dickey * +.\" Copyright 2019-2020,2021 Thomas E. Dickey * .\" Copyright 2002-2011,2012 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -27,7 +27,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_border_set.3x,v 1.13 2020/02/02 23:34:34 tom Exp $ +.\" $Id: curs_border_set.3x,v 1.15 2021/12/25 21:41:58 tom Exp $ .TH curs_border_set 3X "" .ie \n(.g .ds `` \(lq .el .ds `` `` @@ -36,168 +36,168 @@ .na .hy 0 .SH NAME -\fBborder_set\fR, -\fBwborder_set\fR, -\fBbox_set\fR, -\fBhline_set\fR, -\fBwhline_set\fR, -\fBmvhline_set\fR, -\fBmvwhline_set\fR, -\fBvline_set\fR, -\fBwvline_set\fR, -\fBmvvline_set\fR, -\fBmvwvline_set\fR \- create \fBcurses\fR borders or lines using complex characters and renditions +\fBborder_set\fP, +\fBwborder_set\fP, +\fBbox_set\fP, +\fBhline_set\fP, +\fBwhline_set\fP, +\fBmvhline_set\fP, +\fBmvwhline_set\fP, +\fBvline_set\fP, +\fBwvline_set\fP, +\fBmvvline_set\fP, +\fBmvwvline_set\fP \- create \fBcurses\fP borders or lines using complex characters and renditions .ad .hy .SH SYNOPSIS .PP -\fB#include \fR +\fB#include \fP .sp -\fBint border_set(\fR - \fBconst cchar_t *\fR\fIls\fR, \fBconst cchar_t *\fR\fIrs\fR, - \fBconst cchar_t *\fR\fIts\fR, \fBconst cchar_t *\fR\fIbs\fR, - \fBconst cchar_t *\fR\fItl\fR, \fBconst cchar_t *\fR\fItr\fR, - \fBconst cchar_t *\fR\fIbl\fR, \fBconst cchar_t *\fR\fIbr\fR -\fB);\fR -.br -\fBint wborder_set(\fR - \fBWINDOW *win\fR, - \fBconst cchar_t *\fR\fIls\fR, \fBconst cchar_t *\fR\fIrs\fR, - \fBconst cchar_t *\fR\fIts\fR, \fBconst cchar_t *\fR\fIbs\fR, - \fBconst cchar_t *\fR\fItl\fR, \fBconst cchar_t *\fR\fItr\fR, - \fBconst cchar_t *\fR\fIbl\fR, \fBconst cchar_t *\fR\fIbr\fR\fB);\fR -.br -\fBint box_set(\fR - \fBWINDOW *win\fR, - \fBconst cchar_t *\fR\fIverch\fR, - \fBconst cchar_t *\fR\fIhorch\fR\fB);\fR -.br -\fBint hline_set(\fR - \fBconst cchar_t *\fR\fIwch\fR, \fBint \fR\fIn\fR\fB);\fR -.br -\fBint whline_set(\fR - \fBWINDOW *\fR\fIwin\fR, - \fBconst cchar_t *\fR\fIwch\fR, \fBint \fR\fIn\fR\fB);\fR -.br -\fBint mvhline_set(\fR - \fBint \fR\fIy\fR, \fBint \fR\fIx\fR, - \fBconst cchar_t *\fR\fIwch\fR, \fBint \fR\fIn\fR\fB);\fR -.br -\fBint mvwhline_set(\fR - \fBWINDOW *\fR\fIwin\fR, - \fBint \fR\fIy\fR, \fBint \fR\fIx\fR, - \fBconst cchar_t *\fR\fIwch\fR, \fBint \fR\fIn\fR\fB);\fR -.br -\fBint vline_set(\fR - \fBconst cchar_t *\fR\fIwch\fR, \fBint \fR\fIn\fR\fB);\fR -.br -\fBint wvline_set(\fR - \fBWINDOW *\fR\fIwin\fR, - \fBconst cchar_t *\fR\fIwch\fR, \fBint \fR\fIn\fR\fB);\fR -.br -\fBint mvvline_set(\fR - \fBint \fR\fIy\fR, \fBint \fR\fIx\fR, - \fBconst cchar_t *\fR\fIwch\fR, \fBint \fR\fIn\fR\fB);\fR -.br -\fBint mvwvline_set(\fR - \fBWINDOW *\fR\fIwin\fR, - \fBint \fR\fIy\fR, \fBint \fR\fIx\fR, - \fBconst cchar_t *\fR\fIwch\fR, \fBint \fR\fIn\fR\fB);\fR +\fBint border_set(\fP + \fBconst cchar_t *\fP\fIls\fP, \fBconst cchar_t *\fP\fIrs\fP, + \fBconst cchar_t *\fP\fIts\fP, \fBconst cchar_t *\fP\fIbs\fP, + \fBconst cchar_t *\fP\fItl\fP, \fBconst cchar_t *\fP\fItr\fP, + \fBconst cchar_t *\fP\fIbl\fP, \fBconst cchar_t *\fP\fIbr\fP +\fB);\fP +.br +\fBint wborder_set(\fP + \fBWINDOW *win\fP, + \fBconst cchar_t *\fP\fIls\fP, \fBconst cchar_t *\fP\fIrs\fP, + \fBconst cchar_t *\fP\fIts\fP, \fBconst cchar_t *\fP\fIbs\fP, + \fBconst cchar_t *\fP\fItl\fP, \fBconst cchar_t *\fP\fItr\fP, + \fBconst cchar_t *\fP\fIbl\fP, \fBconst cchar_t *\fP\fIbr\fP\fB);\fP +.br +\fBint box_set(\fP + \fBWINDOW *win\fP, + \fBconst cchar_t *\fP\fIverch\fP, + \fBconst cchar_t *\fP\fIhorch\fP\fB);\fP +.br +\fBint hline_set(\fP + \fBconst cchar_t *\fP\fIwch\fP, \fBint \fP\fIn\fP\fB);\fP +.br +\fBint whline_set(\fP + \fBWINDOW *\fP\fIwin\fP, + \fBconst cchar_t *\fP\fIwch\fP, \fBint \fP\fIn\fP\fB);\fP +.br +\fBint mvhline_set(\fP + \fBint \fP\fIy\fP, \fBint \fP\fIx\fP, + \fBconst cchar_t *\fP\fIwch\fP, \fBint \fP\fIn\fP\fB);\fP +.br +\fBint mvwhline_set(\fP + \fBWINDOW *\fP\fIwin\fP, + \fBint \fP\fIy\fP, \fBint \fP\fIx\fP, + \fBconst cchar_t *\fP\fIwch\fP, \fBint \fP\fIn\fP\fB);\fP +.br +\fBint vline_set(\fP + \fBconst cchar_t *\fP\fIwch\fP, \fBint \fP\fIn\fP\fB);\fP +.br +\fBint wvline_set(\fP + \fBWINDOW *\fP\fIwin\fP, + \fBconst cchar_t *\fP\fIwch\fP, \fBint \fP\fIn\fP\fB);\fP +.br +\fBint mvvline_set(\fP + \fBint \fP\fIy\fP, \fBint \fP\fIx\fP, + \fBconst cchar_t *\fP\fIwch\fP, \fBint \fP\fIn\fP\fB);\fP +.br +\fBint mvwvline_set(\fP + \fBWINDOW *\fP\fIwin\fP, + \fBint \fP\fIy\fP, \fBint \fP\fIx\fP, + \fBconst cchar_t *\fP\fIwch\fP, \fBint \fP\fIn\fP\fB);\fP .br .SH DESCRIPTION .PP The -\fBborder_set\fR +\fBborder_set\fP and -\fBwborder_set\fR +\fBwborder_set\fP functions draw a border around the edges of the current or specified window. These functions do not change the cursor position, and do not wrap. .PP Other than the window, each argument is a complex character with attributes: .RS -\fIls\fR \- left side, +\fIls\fP \- left side, .br -\fIrs\fR \- right side, +\fIrs\fP \- right side, .br -\fIts\fR \- top side, +\fIts\fP \- top side, .br -\fIbs\fR \- bottom side, +\fIbs\fP \- bottom side, .br -\fItl\fR \- top left-hand corner, +\fItl\fP \- top left-hand corner, .br -\fItr\fR \- top right-hand corner, +\fItr\fP \- top right-hand corner, .br -\fIbl\fR \- bottom left-hand corner, and +\fIbl\fP \- bottom left-hand corner, and .br -\fIbr\fR \- bottom right-hand corner. +\fIbr\fP \- bottom right-hand corner. .RE .PP If any of these arguments is zero, then the corresponding -default values (defined in \fBcurses.h\fR) are used instead: +default values (defined in \fBcurses.h\fP) are used instead: .RS -\fBWACS_VLINE\fR, +\fBWACS_VLINE\fP, .br -\fBWACS_VLINE\fR, +\fBWACS_VLINE\fP, .br -\fBWACS_HLINE\fR, +\fBWACS_HLINE\fP, .br -\fBWACS_HLINE\fR, +\fBWACS_HLINE\fP, .br -\fBWACS_ULCORNER\fR, +\fBWACS_ULCORNER\fP, .br -\fBWACS_URCORNER\fR, +\fBWACS_URCORNER\fP, .br -\fBWACS_LLCORNER\fR, and +\fBWACS_LLCORNER\fP, and .br -\fBWACS_LRCORNER\fR. +\fBWACS_LRCORNER\fP. .RE .PP -\fBbox_set(\fR\fIwin\fR, \fIverch\fR\fB, \fR\fIhorch\fR\fB);\fR +\fBbox_set(\fP\fIwin\fP, \fIverch\fP\fB, \fP\fIhorch\fP\fB);\fP is a shorthand for the following call: .PP -\fBwborder_set(\fR\fIwin\fR\fB, \fR\fIverch\fR\fB, \fR\fIverch\fR\fB,\fR - \fIhorch\fR\fB, \fR\fIhorch\fR\fB, NULL, NULL, NULL, NULL);\fR +\fBwborder_set(\fP\fIwin\fP\fB, \fP\fIverch\fP\fB, \fP\fIverch\fP\fB,\fP + \fIhorch\fP\fB, \fP\fIhorch\fP\fB, NULL, NULL, NULL, NULL);\fP .PP The -\fB*line_set\fR +\fB*line_set\fP functions use -\fIwch\fR +\fIwch\fP to draw a line starting at the current cursor position in the window. -The line is at most \fIn\fR characters long or as many as fit into the window. +The line is at most \fIn\fP characters long or as many as fit into the window. The current cursor position is not changed. .PP The -\fBhline_set\fR, -\fBmvhline_set\fR, -\fBmvwhline_set\fR, and -\fBwhline_set\fR +\fBhline_set\fP, +\fBmvhline_set\fP, +\fBmvwhline_set\fP, and +\fBwhline_set\fP functions draw a line proceeding toward the last column of the same line. .PP The -\fBvline_set\fR, -\fBmvvline_set\fR, -\fBmvwvline_set\fR, and -\fBwvline_set\fR +\fBvline_set\fP, +\fBmvvline_set\fP, +\fBmvwvline_set\fP, and +\fBwvline_set\fP functions draw a line proceeding toward the last line of the window. .br .SH NOTES .PP Note that -\fBborder_set\fR, -\fBhline_set\fR, -\fBmvhline_set\fR, -\fBmvvline_set\fR, -\fBmvwhline_set\fR, -\fBmvwvline_set\fR, and -\fBvline_set\fR +\fBborder_set\fP, +\fBhline_set\fP, +\fBmvhline_set\fP, +\fBmvvline_set\fP, +\fBmvwhline_set\fP, +\fBmvwvline_set\fP, and +\fBvline_set\fP may be macros. .br .SH RETURN VALUE .PP Upon successful completion, these functions return -\fBOK\fR. +\fBOK\fP. Otherwise, they return -\fBERR\fR. +\fBERR\fP. .PP Functions using a window parameter return an error if it is null. .PP @@ -205,7 +205,7 @@ Functions with a \*(``mv\*('' prefix first perform a cursor movement using \fBwmove\fP, and return an error if the position is outside the window, or if the window pointer is null. .SH SEE ALSO -\fBncurses\fR(3X), -\fBcurs_add_wch\fR(3X), -\fBcurs_border\fR(3X), -\fBcurs_outopts\fR(3X) +\fBncurses\fP(3X), +\fBcurs_add_wch\fP(3X), +\fBcurs_border\fP(3X), +\fBcurs_outopts\fP(3X)