%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)