Defines a background box on a form
| Call | ||||
| #include <vv_form.h> | ||||
| BG_BOXPTR bg_boxdef(wn_rb, wn_cb, rowq, colq, att, bdrp, fmp) | ||||
|
int wn_rb |
Row in form window to begin box |
|||
| int wn_cb | Column in form window to begin box | |||
| int rowq | Number of rows in the box | |||
| int colq | Number of columns in the box | |||
| UCHAR att | Video attribute of the box | |||
| BORDERPTR bdrp | Border type to use for box | |||
| FormPTR | Pointer to form to place box on | |||
| Description of Parameters
bdrp: Specify a pointer to a border type. The following borders are defined by the system. Appearance is operating system dependent |
||||
|
BDR_SLNP |
Single-line border |
|||
| BDR_DLNP | Double-line border | |||
| BDR_SPACEP | Space character border | |||
| BDR_DOTP | Stippled block graphics character or dot/colon border | |||
| BDR_STARP | Asterisk border | |||
| BDR_SOLIDP | Solid block graphics character or space border | |||
| Returns | ||||
| POINTER | A pointer to the background box structure for the box | |||
| NULLP | Error. VV_ERR is set to the following: | |||
| MEMLACK | Insufficient memory is available to allocate for a background box structure. | |||
| Description
bg_boxdef() allocates memory for a new node in the linked list of background items for the form. The node for this background box is inserted in the appropriate place in the linked list. The order of the nodes are maintained so that all scrollable region backgrounds are listed first, followed by lines, boxes, and text. The structure members for the background box structure are initialized to the values specified in the call. If the style of the box is either BDR_SLNP or BDR_DLNP, the box will properly intersect lines or other boxes. |
||||
| Cautions
Under VMS and non-memory mapped UNIX displays, the terminal must be set to block graphics mode before the line can be drawn. If you specify one of the Vermont Views system logical attributes, Vermont Views will set the terminal to block graphics mode. However, the attribute you specified will be ignored; the line will be displayed in normal video. |
||||
| Related Functions | ||||
