<--- Cannot embed stylesheet: [Errno 2] No such file or directory: '../../../../aros.css' --->

Panel.mui

MUIA_Panel_Collapsed

Function

Hide or show panel content.

Inputs

Initialize, set and get, BOOL; default FALSE.

Notes

The title stores the state. Setup applies initial collapse; changed Set
keeps title/handle visible and sets all other children ShowMe to the
inverse, then requests group layout and redraw. Expanding does not
restore independently hidden children. A first runtime collapse without
valid current or saved geometry is rejected locally. Get returns the
title state with TRUE, or FALSE without a title. No-title panels cannot
reliably reverse a collapse because no state is retained. Direct changes
do not refresh PanelGroup caches.

MUIA_Panel_Collapsible

Function

Allow title-click toggling.

Inputs

Initialize, set and get, BOOL; default FALSE.

Notes

Forwarded to PanelTitle when present. Direct Panel_Collapsed Set is not
gated by this option. Changing it after Setup does not allocate missing
arrow resources. Without a title Get returns FALSE with TRUE and Set has
no local effect. PanelGroup caches this option and does not
automatically track later changes.

MUIA_Panel_Draggable

Function

Identify a declared Panel-specific tag with no local behavior.

Inputs

Declared in panel.h; no local initialization, Set or Get case.

Notes

Use inherited MUIA_Draggable for the implemented handle path. Do not
infer that this similarly named identifier creates a handle or enables
dragging. The inherited constructor path creates a handle on tag
presence even for FALSE; see the class limitations.

MUIA_Panel_DrawSeparator

Function

Request a line beside the title when expanded.

Inputs

Initialize and set, BOOL; default TRUE for a Panel-created title. No
local Panel getter.

Notes

Forwarded to PanelTitle_ShowSeparator. The title draws a horizontal line
at Top or vertical line at Left only when not collapsed. The title size
calculation still includes the separator when collapsed. Without a title
there is no local effect.

MUIA_Panel_DrawStateIndicator

Function

Choose whether the title draws a collapse arrow.

Inputs

Initialize only locally, BOOL; default FALSE. No local Panel Set/Get
case.

Notes

Passed to PanelTitle at construction. Arrow drawing also requires
Collapsible and available vector resources. Hiding the indicator does
not disable clicking or remove reserved arrow space. Setting this Panel
tag later has no local implementation.

MUIA_Panel_Padding

Function

Store the panel padding value.

Inputs

Initialize, set and get, integer stored as UWORD. Default zero.

Notes

The field has no layout or drawing consumer. Set requests redraw when
changed but does not add spacing. Large values truncate. Get returns
TRUE with the stored value; use inherited Group/Area spacing controls
for their documented effects.

MUIA_Panel_Title

Function

Set or read the title text.

Inputs

Initialize, set and get, terminated STRPTR. Default no title.

Notes

Construction copies the text through a new PanelTitle only when
TitlePosition is not None. Set replaces text in an existing title and
otherwise has no local effect. Get returns TRUE with a borrowed pointer
to the owned copy, or NULL without a title. Copy it before
replacement/disposal; do not free it or pass the same owned pointer back
to Set, which frees it before copying. Avoid empty text with left
vertical rendering. Allocation failure is not reported as Panel creation
or Set failure.

MUIA_Panel_TitleClickedHook

Function

Install the callback for title clicks.

Inputs

Initialize and set, borrowed struct Hook pointer; default NULL. No local
Panel getter.

Notes

Forwarded to an existing title. On SELECTDOWN inside it, PanelTitle
first attempts Toggle if collapsible, then calls CallHookPkt(hook,
titleObject, NULL), ignoring the hook result and consuming the event.
The object argument is PanelTitle, not Panel. Keep hook and callback
state alive through use; callbacks must preserve objects needed by the
remaining synchronous event path.

MUIA_Panel_TitlePosition

Function

Select the title position used at construction.

Inputs

Initialize, set and get, ULONG: None (0, default), Top (1), Left (2).

Notes

Construction uses Left for horizontal grouping and creates a title only
with non-NULL Title and non-None position. Get without a title returns
None with TRUE. Set only forwards to an existing PanelTitle: it neither
removes the title for None nor changes Group/handle orientation.
PanelTitle position replacement also has resource-lifecycle defects;
recreate the Panel to change its arrangement.

MUIA_Panel_TitleTextPosition

Function

Align text within the title.

Inputs

Initialize, set and get, ULONG: Centered (0, default), Left (1), Right
(2).

Notes

Forwarded to an existing PanelTitle. For vertical text, Left means near
the top and Right near the bottom. Unknown values use centered drawing.
No title means Set has no effect and Get returns Centered with TRUE.
Alignment does not change parent Group orientation.

MUIA_Panel_TitleVertical

Function

Render left-side title text as stacked characters.

Inputs

Initialize, set and get, BOOL; default FALSE.

Notes

Forwarded to an existing PanelTitle. Effective only with Left position;
characters are stacked rather than rotated. Use nonempty text, since
empty vertical text reaches division by its length. Set invalidates
title measurements and requests redraw, but no explicit parent relayout.
Get without a title returns FALSE with TRUE.

MUIC_Panel

Superclass

Group.mui

Description

A Group with an optional PanelTitle and drag handle. A non-NULL
Title and non-None TitlePosition at construction create the title; later
sets cannot create one. Left titles select horizontal grouping unless
caller Group tags override it. Group owns all generated children.

Methods

Collapsed hides content, not the title or handle; expanding makes
all content children visible rather than restoring their earlier state.
First collapse requires positive geometry or saved dimensions. Without
a title, collapsed state is not usable. Title clicks bypass PanelGroup's
cached state; coordinate changes through PanelGroup if its state matters.

Bugs

MUIA_Panel_Draggable is not implemented; use inherited
MUIA_Draggable. Its mere presence creates a handle, even when FALSE.
Changing title position does not reorient Group/handle. Padding has no
layout effect. Drag-image allocation failure can leave a partial image;
deletion frees the bitmap but not the image structure.