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

PanelGroup.mui

MUIA_PanelGroup_AllowMultiple

Function

Permit the expand-all operation and multiple expanded panels in managed
operations.

Inputs

Initialize, set and get, BOOL normalized; default TRUE.

Notes

Switching to FALSE collapses other cached-collapsible tracked panels
only if ExpandedPanel is non-NULL, and only set-up targets are actually
written. It does not choose a panel when none is recorded. Single
ExpandPanel collapses only the recorded prior panel, not every
independently expanded child. Get returns TRUE with the option; it does
not verify exclusivity.

MUIA_PanelGroup_CollapseAll

Function

Trigger collapse of all eligible tracked panels.

Inputs

Set-only trigger, BOOL; nonzero invokes the operation, zero does
nothing. Not processed by the local constructor; no local getter.

Notes

Calls MUIM_PanelGroup_CollapsePanel with NULL. Clears the recorded
ExpandedPanel even if no node changes. Eligibility and results use
cached flags; pre-Setup calls can change the cache without changing
children. OM_SET returns the superclass result rather than the
operation's changed flag.

MUIA_PanelGroup_DragReordering

Function

Enable drop acceptance and child dragging for panel reordering.

Inputs

Initialize, set and get, BOOL normalized; default FALSE.

Notes

Sets this group Dropable and inherited Draggable on tracked objects;
newly tracked objects are made draggable only when enabled. For Panel
this controls its DragHandle path, not MUIA_Panel_Draggable. Use a
vertical group of Panel children with handles: the drag query expects
handle -> Panel -> this group. Mixed non-panel children are not indexed
consistently. Get returns TRUE with the option, not proof of successful
handle creation or drop.

MUIA_PanelGroup_ExpandAll

Function

Trigger expansion of all eligible tracked panels.

Inputs

Set-only trigger, BOOL; nonzero invokes the operation, zero does
nothing. Not processed by the local constructor; no local getter.

Notes

Calls MUIM_PanelGroup_ExpandPanel with NULL. Does nothing in
single-panel mode. Eligibility and results use cached flags; pre-Setup
calls can change the cache without changing children. OM_SET returns the
superclass result rather than the operation's changed flag.

MUIA_PanelGroup_ExpandedPanel

Function

Store the panel designated as expanded in single-panel mode.

Inputs

Initialize, set and get, borrowed Object pointer; default NULL. Supply a
live child Panel or NULL.

Notes

Construction stores the pointer and can mark layout dirty, but does not
enact initial exclusivity. Changed Set in single-panel mode collapses
the previous live collapsible object and expands the new one through a
setup-only helper. Membership is not validated. Multiple mode only
stores the pointer. Repeating the same pointer does nothing locally. Get
returns TRUE with the recorded pointer, not a scan of visible children;
keep it valid while stored.

MUIC_PanelGroup

Superclass

Group.mui

Description

A Group with cached state for recognized Panel and DragHandle
children. Group owns children; tracking nodes only borrow their pointers.
ScanPanels adds missing nodes but does not remove stale ones or refresh
existing states immediately. A balanced Group change pair refreshes a
cache marked stale. Direct child/title changes do not invalidate it.

Methods

Collapse/Expand/Toggle use cached state. They may update that cache
before Setup without changing the visible child. AllowMultiple FALSE is
not an invariant: externally changed panels and title clicks can bypass
it. To refresh, ScanPanels then perform a balanced Group change pair.
Keep tracked objects alive; ScanPanels does not reconcile removals.

Bugs

Tracking allocation failures are not reported reliably. Drag
reordering expects Handle -> Panel -> PanelGroup; dragging Panel itself
is not accepted. Mixed child types can disrupt position calculations.
A successful drop result need not mean a move; tracking order remains
unchanged. The internal acceptance helper requires a non-NULL object.

MUIM_PanelGroup_CollapsePanel

Synopsis

IPTR result = DoMethod(obj, MUIM_PanelGroup_CollapsePanel, panel);

Function

Collapse one tracked panel or all eligible tracked panels.

Inputs

obj - Live PanelGroup with coherent tracking.
panel - Borrowed live tracked object, or NULL with the method-specific
meaning.

Result

TRUE if cached state changed; FALSE otherwise.

Notes

NULL selects all and clears ExpandedPanel. A specific target must
be tracked, cached-collapsible and cached-expanded. Only set-up panels
are actually changed; the cache can change before Setup. Direct child
changes require the class's cache-refresh sequence.

MUIM_PanelGroup_ExpandPanel

Synopsis

IPTR result = DoMethod(obj, MUIM_PanelGroup_ExpandPanel, panel);

Function

Expand one tracked panel or all eligible tracked panels.

Inputs

obj - Live PanelGroup with coherent tracking.
panel - Borrowed live tracked object, or NULL with the method-specific
meaning.

Result

TRUE if cached state changed; FALSE otherwise.

Notes

NULL expands all only with AllowMultiple TRUE. A specific target
must be tracked, cached-collapsible and cached-collapsed. Single-panel
mode collapses only the previously recorded ExpandedPanel, not every
independently expanded child. Cache changes can precede Setup; direct
child changes require the class's cache-refresh sequence.

MUIM_PanelGroup_GetPanelState

Synopsis

IPTR result = DoMethod(obj, MUIM_PanelGroup_GetPanelState, panel);

Function

Read a tracked panel's cached collapse state.

Inputs

obj - Live PanelGroup with coherent tracking.
panel - Borrowed live tracked object, or NULL with the method-specific
meaning.

Result

MUIV_PanelGroup_Panel_Collapsed (0) or MUIV_PanelGroup_Panel_Expanded
(1). NULL and untracked targets also return Expanded.

Notes

Unknown and untracked objects return Expanded, as do expanded
panels. No live query or cache refresh occurs. See the class-level
synchronization requirements.

MUIM_PanelGroup_ScanPanels

Synopsis

IPTR result = DoMethod(obj, MUIM_PanelGroup_ScanPanels);

Function

Add recognized direct children to the tracking list.

Inputs

obj - Live PanelGroup with stable child list; previously tracked objects
must still be alive.

Result

FALSE when the child list is unavailable; TRUE after scanning, even if
individual tracking-node allocations failed.

Notes

Recognizes direct Panel and DragHandle children, including
subclasses. Adds missing nodes but does not remove departed children or
refresh the retained nodes immediately. The count reflects recognized
children, not successful allocations. Marks the cache stale; a balanced
Group change pair refreshes it. No ownership transfer occurs.

MUIM_PanelGroup_TogglePanel

Synopsis

IPTR result = DoMethod(obj, MUIM_PanelGroup_TogglePanel, panel);

Function

Choose collapse or expansion from a tracked panel's cached state.

Inputs

obj - Live PanelGroup with coherent tracking.
panel - Borrowed live tracked object, or NULL with the method-specific
meaning.

Result

The selected CollapsePanel/ExpandPanel result, or FALSE for NULL,
untracked or cached-noncollapsible target.

Notes

NULL does not mean all. Uses cached state rather than querying
the child. Cache changes can precede Setup; see class synchronization
requirements for direct child changes.