Supply or retrieve the separator title.

Initialize and get, STRPTR. Default NULL. Supply a readable

NUL-terminated string; NULL leaves no title.

The constructor copies the string. Get returns the owned copy as a

borrowed pointer; do not free or modify it, and do not retain it after

disposal. No local setter exists. Use at most one BarTitle tag: repeated

tags leak earlier copies. Copy failure leaves no title but does not fail

construction.

The Zune text engine parses the title at Setup. An empty string remains

a present title and takes the title layout/drawing path. With HBar, the

line is split around centered text; with VBar, only the title is drawn.

Title allocation at Setup is not checked before later sizing/drawing

dereferences the text object.

Select or query a horizontal separator.

Initialize and get, BOOL. Default FALSE when no bar tag is supplied.

The presence of this constructor tag selects its separator even when its

value is FALSE. If HBar and VBar both occur, the last tag selects the

type; getters report only that selected type. No local setter exists.

Without a title, the separator is a centered two-pixel line and adds two

pixels to the corresponding minimum thickness. With a title, HBar draws

side segments if space permits; VBar draws no separator line. Both

maximum size dimensions remain flexible.

Select or query a vertical separator.

Initialize and get, BOOL. Default FALSE when no bar tag is supplied.

The presence of this constructor tag selects its separator even when its

value is FALSE. If HBar and VBar both occur, the last tag selects the

type; getters report only that selected type. No local setter exists.

Without a title, the separator is a centered two-pixel line and adds two

pixels to the corresponding minimum thickness. With a title, HBar draws

side segments if space permits; VBar draws no separator line. Both

maximum size dimensions remain flexible.

Area.mui

Provide flexible space, a separator line or a title. The default has no

title or separator. Construction prepends the title-font selection;

caller tags can override it. This class has no local setter for its

attributes. Version and Revision both return 1 and are class values, not

library version numbers.

A title is copied with StrDup during construction and freed on disposal.

Setup creates a separate Zune text object; Cleanup destroys that object

before calling Area. Complete Cleanup before disposal. Cleanup does not

clear its text pointer, so repeating Cleanup without a matching Setup

can free stale storage.

Setup returns FALSE on Area setup failure, otherwise TRUE even if text

allocation fails. With a stored title, AskMinMax and Draw dereference

the text object without checking that allocation succeeded. Constructor

title-copy failure instead leaves the object without a title and does

not fail construction.

Without a title, AskMinMax adds two pixels to minimum height for HBar or

minimum width for VBar. With a title it uses measured text dimensions,

adding one pixel in each dimension for the 3D title preference. Default

sizes equal resulting minimum sizes; both maxima become MUI_MAXMAX.

AskMinMax returns TRUE.

Draw first calls Area and returns zero unless MADF_DRAWOBJECT is set. It

returns TRUE for empty content geometry or after drawing. A title is

centered and colored using the group-title preference. HBar adds

separated line segments on either side when space permits; VBar has no

line when a title is present. Without a title, HBar or VBar paints a

centered two-pixel separator. A normal rectangle draws no additional

content in a nondebug build.

Use a valid connected render context and normal

Setup/AskMinMax/Draw/Cleanup ordering. No native gadget is created. Bar

tags select a type by presence, regardless of their BOOL value; if both

are present, the last one wins. Repeating BarTitle at construction leaks

earlier copies because each tag overwrites the previous pointer without

freeing it.