Character windows - border and shadow properties

border = integer
shadow = integer

Applicable to:
Windows; buttons; button groups; listboxes; textboxes; textbox groups

These clauses are used to define the border and shadow style to be used in the display of windows and window controls under character windows. If the terminal parameter file is correctly set up, sensible border and shadow styles are already defined. It is only necessary to use these clauses when a non-standard border or shadow is required.

Border and shadow styles are defined in the include file $SCULPTOR/include/sculptor.h. The available styles are listed under Border and shadow styles below.

Either the definition or the number following it may be used. The following two clauses, for example, are identical:

border = 5
border = SPACES_SINGLE_LINE

Border styles with the prefix DELIM_ define left and right delimiters, and are particularly suitable for use with textboxes.

Special cases

border = 0

No border.

shadow = 0

No shadow

border = DEF_BORDER
shadow = DEF_SHADOW

Requests the default border/shadow for the object. The default is defined for the current palette in Section 11 of the terminal parameter file, unless a border/shadow has been defined at group level, in which case this becomes the default for all controls in the group

border clause absent

The default border DEF_BORDER is assumed.

shadow clause absent

The default shadow DEF_SHADOW is assumed


Default border and shadow

The default border and shadow for a window object are determined by the window palette. Section 11 of the terminal parameter file stores the border and shadow styles for objects within that palette. The entry number is the palette number; sub-entries each relate to a different object, and consist of two integers, the first indicating the border number, the second the shadow number. A zero indicates that no border or shadow should be used.

The example below shows a set of defaults:

11[1]:  Background character = SPC
11[2]:  Default border, shadow for window = 1, 0       /* Single line border, no shadow */
11[3]:  Default border, shadow for text box = 11, 0    /* Square bracket textbox delimiters, no shadow */
11[4]:  Default border, shadow for push button = 0, 1  /* No border, shadow 1 (bottom right) */
11[5]:  Default border, shadow for multi button = 0, 0
11[6]:  Default border, shadow for static text = 0, 0
11[7]:  Default border, shadow for ring menu = 1, 0
11[8]:  Default border, shadow for listbox = 1, 0

Border and shadow styles


Border styles

SINGLE_LINE (1)

Single line all round

DOUBLE_LINE (2)

Double line all round

SINGLE_LINE_BARS (3)

Single line with title bars

DOUBLE_LINE_BARS (4)

Double line with title bars

SPACES_SINGLE_LINE (5)

Spaces top, single line sides

SPACES_DOUBLE_LINE (6)

Spaces top, double line sides

NULL_BORDER (10)

Null border

DELIM_BRACKETS (11)

[ ] delimiters

DELIM_VERTBARS (12)

| | delimiters

DELIM_LINES (13)

Graphics line delimiters

DELIM_PARENTHESES (14)

( ) delimiters

DELIM_ANGLES (15)

<> delimiters

DELIM_DOWNARROWS (16)

Space delimiters

DELIM_SPACES (19)

<> delimiters


Shadow styles

BOTTOM_RIGHT (1)

Bottom right shadow

BOTTOM_LEFT (2)

Bottom left shadow

TOP_RIGHT (3)

Top right shadow

TOP_LEFT (4)

Top left shadow

ALL_ROUND (5)

All round shadow


RELATED TOPICS

Character windows

Terminal parameter files