Character windows - border and shadow properties¶
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 = 5border = 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 |