%ob - Open Box

Purpose

To open a box.

Syntax

winio@('%ob[options][title]')
winio@('%n.mob[options][title]')

Modifiers

Grave accent (`) - provides a shaded background.

Description

Defines the top left hand corner of a rectangular box into which subsequent objects are to be placed until a corresponding %cb (Close Box) format is encountered.

title is optional and is a standard character string that is used with an option from the options list that sets a title to the box.

options is can be one or more of:

 

 

named_c

Splices a name into the top line of the box (in the centre)

 

named_l

Splices a name into the top line of the box (on the left).

 

named_r

Splices a name into the top line of the box (on the right)

 

named

The same as named_c.

 

nameless

Occupies the same vertical space as named_c etc. but has no name.

 

no_border

Create an invisible box which is useful for grouping controls.

 

invisible

The same as no_border.

 

panelled

This replaces the simple line box with a 3-dimensional panel.

 

thin_panelled

Similar to panelled but perhaps a slightly more attractive effect.

 

shaded

This has the same effect as the use of the grave accent.

 

status

This provides a box in the form of a status bar.

 

bottom_exit

Begins the next control below this box rather than to the right.

 

scored

Double line, 3-dimensional shade effect.

 

depressed

Single line, 3-dimensional shade effect.

 

raised

Single line, 3-dimensional shade effect

 

rounded

Rounded corners

 

line_colour

Provides the RGB value for the line colour of a simple box. The value is provided as winio@ argument (after the box name when a name is used).


 

 

When n and m are used, %ob creates a rectangular grid of boxes (n across, m down) each requiring its own %cb (Close Box). Thus %3.2ob would require six %cb (Close Box) codes. A title cannot be supplied for a grid of boxes. When used with the option no_border, this provides a mechanism for positioning text and controls within rectangular sub regions of the window (see Box format for a simple example).

%ap (Absolute Position) can be used before %ob in order to specify the position of the box from the %ap arguments.

Notes

%ob boxes can be nested, one within another, in order to provide a fine control over the positioning of items in a window.

The options scored, depressed and raised should not be used with a background colour of white or black (grey is typical).

Example

winio@('%ob[named_r][Results]')

See also

%ap (Absolute Position)


 

 

 

Basket
Empty
 
Copyright © 1999-2024 Silverfrost Limited