Block Format Functions

Block format functions affect the layout of the page. The table in this section lists and describes these functions. These functions support Netscape extensions to HTML.

os_center() and os_no_line_break() return an os_element_group object. The effect of the function is applied to all contents of the object. Each block format function is overloaded to provide the following forms.

os_element_group& form1()

os_element_group& form2( const os_element&element )

os_element_group& form3( const string&text )

The initial contents of an os_element_group object are determined by the form of the block format function called.

Form 1-Returns an empty os_element_group object.
Form 2-Returns an os_element_group object containing a copy of element .
Form 3-Returns an os_element_group object containing an os_text object constructed from text.

Additional elements can be added to the os_element_group object returned, regardless of the form of the block format function called.

The block format function os_word_break takes no arguments and returns an os_element .

Block Format Functions Effect

os_center

Centers the contents between the left and right page margins.

os_no_line_break

Displays the contents as a single line of text without line breaks.

os_word_break

Places a marker where a line break is allowed in the contents of an os_no_line_break() object. It does not force a line break; it merely signals that a line break is acceptable. Returns an os_element object and takes no arguments.

Block Format Functions	Effect
`os_center`	Centers the contents between the left and right page margins.
`os_no_line_break`	Displays the contents as a single line of text without line breaks.
`os_word_break`	Places a marker where a line break is allowed in the contents of an `os_no_line_break()` object. It does not force a line break; it merely signals that a line break is acceptable. Returns an `os_element` object and takes no arguments.