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

Boopsi.mui

MUIA_Boopsi_Class

Function

Select the private IClass pointer passed to NewObjectA on Show.

Inputs

Initialize and set. Borrowed struct IClass pointer; default NULL. No
dedicated local getter despite the header get flag.

Notes

Class and ClassID are passed together to Intuition NewObjectA; a
non-NULL Class pointer takes precedence, otherwise ClassID selects the
public class. Keep the referenced class/name valid while future Show
calls may use it. Set updates the stored selector but does not replace a
current gadget; it also forwards the original tags to that gadget
through the ordinary setter path. The next Show uses the stored
selectors.

MUIA_Boopsi_ClassID

Function

Select the public class name string passed to NewObjectA on Show.

Inputs

Initialize and set. Borrowed terminated string pointer; default NULL. No
dedicated local getter despite the header get flag.

Notes

Class and ClassID are passed together to Intuition NewObjectA; a
non-NULL Class pointer takes precedence, otherwise ClassID selects the
public class. Keep the referenced class/name valid while future Show
calls may use it. Set updates the stored selector but does not replace a
current gadget; it also forwards the original tags to that gadget
through the ordinary setter path. The next Show uses the stored
selectors.

MUIA_Boopsi_MaxHeight

Function

Supply the gadget content maximum height for layout.

Inputs

Initialize and set, ULONG in the header, stored as int. Default
MUI_MAXMAX. No dedicated local getter despite the header get flag.

Notes

AskMinMax adds this value to the superclass maximum height. No sign,
overflow or minimum/maximum consistency validation is performed. Set
stores the value but does not explicitly request a layout recalculation.
The class does not query gadget dimensions to replace these bounds.

MUIA_Boopsi_MaxWidth

Function

Supply the gadget content maximum width for layout.

Inputs

Initialize and set, ULONG in the header, stored as int. Default
MUI_MAXMAX. No dedicated local getter despite the header get flag.

Notes

AskMinMax adds this value to the superclass maximum width. No sign,
overflow or minimum/maximum consistency validation is performed. Set
stores the value but does not explicitly request a layout recalculation.
The class does not query gadget dimensions to replace these bounds.

MUIA_Boopsi_MinHeight

Function

Supply the gadget content minimum height for layout.

Inputs

Initialize and set, ULONG in the header, stored as int. Default zero. No
dedicated local getter despite the header get flag.

Notes

AskMinMax adds this value to the superclass minimum and default height.
No sign, overflow or minimum/maximum consistency validation is
performed. Set stores the value but does not explicitly request a layout
recalculation. The class does not query gadget dimensions to replace
these bounds.

MUIA_Boopsi_MinWidth

Function

Supply the gadget content minimum width for layout.

Inputs

Initialize and set, ULONG in the header, stored as int. Default zero. No
dedicated local getter despite the header get flag.

Notes

AskMinMax adds this value to the superclass minimum and default width.
No sign, overflow or minimum/maximum consistency validation is
performed. Set stores the value but does not explicitly request a layout
recalculation. The class does not query gadget dimensions to replace
these bounds.

MUIA_Boopsi_Object

Function

Expose the current embedded gadget pointer through the attribute getter.

Inputs

Get; borrowed Object pointer, NULL before gadget creation and after
Hide.

Bugs

The local case writes the gadget pointer but falls through to
remembered-attribute, gadget and superclass lookup without returning
success. GetAttr can therefore return FALSE after writing a valid
pointer, or a later successful getter can overwrite it. Do not treat
getter success as a reliable presence test in this implementation. A
captured pointer is valid only until Hide or gadget replacement; never
dispose it separately.

MUIA_Boopsi_Remember

Function

Record a gadget attribute whose value should survive gadget recreation.

Inputs

Initialize only, ULONG attribute ID. Repeat this tag for each attribute.
Default: no remembered attributes; no local setter/getter.

Notes

Each successfully allocated record starts with the first matching
constructor tag value or zero. Set updates it from the first matching
tag. Get refreshes from the live gadget when its getter succeeds,
otherwise returns the cached value with TRUE. Hide calls the gadget
getter directly into each cached value and ignores its status. Show
applies the remembered tags after NewObjectA and before AddGadget.
Only values are stored, not deep copies of pointer targets. Do not
remember a pointer owned by a gadget that Hide will dispose unless the
underlying API guarantees a sufficient lifetime. Allocation failure
silently omits the new record; duplicate IDs are not deduplicated. Use
ordinary gadget attribute IDs, not tag-list control IDs.

MUIA_Boopsi_Smart

Function

Store the constructor Smart flag without changing wrapper behavior.

Inputs

Initialize only, BOOL in the header, stored as ULONG. Default zero. No
dedicated local setter or getter.

Notes

The implementation stores this value but does not consult it in Show,
Hide, Draw, event routing or disposal. It does not enable another
clipping, rendering or lifecycle mode.

MUIA_Boopsi_TagDrawInfo

Function

Choose the gadget tag that receives the current draw information pointer
on Show.

Inputs

Initialize and set, ULONG gadget attribute ID. Default zero disables
substitution. No dedicated local getter despite the header get flag.

Notes

The corresponding gadget tag must already exist in the cloned
constructor list, typically with an initial zero value. Show replaces
its first occurrence with the borrowed current DrawInfo pointer before
NewObjectA; it does not add a missing tag. Set changes the mapping for
future Show calls but does not rebuild the constructor list or recreate
a current gadget. These context pointers remain owned by the surrounding
screen/window lifecycle.

MUIA_Boopsi_TagScreen

Function

Choose the gadget tag that receives the current screen pointer on Show.

Inputs

Initialize and set, ULONG gadget attribute ID. Default zero disables
substitution. No dedicated local getter despite the header get flag.

Notes

The corresponding gadget tag must already exist in the cloned
constructor list, typically with an initial zero value. Show replaces
its first occurrence with the borrowed current Screen pointer before
NewObjectA; it does not add a missing tag. Set changes the mapping for
future Show calls but does not rebuild the constructor list or recreate
a current gadget. These context pointers remain owned by the surrounding
screen/window lifecycle.

MUIA_Boopsi_TagWindow

Function

Choose the gadget tag that receives the current window pointer on Show.

Inputs

Initialize and set, ULONG gadget attribute ID. Default zero disables
substitution. No dedicated local getter despite the header get flag.

Notes

The corresponding gadget tag must already exist in the cloned
constructor list, typically with an initial zero value. Show replaces
its first occurrence with the borrowed current Window pointer before
NewObjectA; it does not add a missing tag. Set changes the mapping for
future Show calls but does not rebuild the constructor list or recreate
a current gadget. These context pointers remain owned by the surrounding
screen/window lifecycle.

MUIC_Boopsi

Superclass

Area.mui

Description

Embed an Intuition BOOPSI gadget in a MUI layout. Construction creates
the wrapper, not the gadget, and defaults FillArea to FALSE. Show
creates the gadget from the selected class and a shallow clone of the
constructor tags, then applies remembered values and adds it to the
window. Hide reads remembered values, removes the gadget, disposes it
and clears the pointer. A later Show creates a new gadget.
Keep the class, ClassID string and any pointer-valued constructor data
alive for every Show that can use them. The wrapper owns the cloned tag
records and remember records, not their pointer targets. It owns each
created gadget. Use the normal Setup/Show/Hide/Cleanup lifecycle:
Cleanup only removes the event handler; Dispose frees the tag records
and delegates, without independently disposing a still-present gadget.
Repeated Show without Hide can overwrite the gadget pointer.
Show suppresses gadget creation if the wrapper is not completely inside
each enclosing virtual group. It returns the superclass result even if
gadget creation fails, and does not stop creation when that result is
zero. Partial visibility is not implemented by clipping a live gadget.

Methods

Setup registers a priority-zero IDCMP_IDCMPUPDATE handler after
successful Area setup. Every received update is passed as tags to the
wrapper with private OnlyTrigger, suppressing forwarding back to the
gadget while still updating remembered values and sending MUI
notifications. Updates are not filtered by gadget ID or originating
object. A notification therefore does not prove that this wrapper's
gadget produced it.
Set forwards the original tag list to an existing gadget with
SetGadgetAttrsA, unless OnlyTrigger is present. A nonzero gadget result
causes RefreshGList immediately; virtual-group clipping is not added
here. The last NoNotify value controls temporary gadget ICA_TARGET
suppression. If nonzero, ICA_TARGET is set to NULL and then to
ICTARGET_IDCMP, not restored to its previous value. MUI notification
suppression is still governed independently by Notify.
Get searches remembered attributes first, refreshing their cached value
only when the live gadget getter succeeds. It then tries the gadget and
finally Area. The wrapper does not provide local getters for its class,
bounds, Smart, Remember or tag-mapping fields despite some header get
flags.
Draw delegates to Area, then refreshes a live gadget for DRAWOBJECT or
DRAWUPDATE and returns one. AskMinMax adds configured minima to
minimum/default sizes and maxima to maximum sizes after Area; it does
not ask the gadget for its preferred size.
Unhandled messages whose upper sixteen MethodID bits differ from the
classic MUI tag prefix are sent directly to a live gadget, with its
result returned. Other messages go to Area. This is a numeric-prefix
test, not general knowledge of all MUI extension methods.

Notes

Supply GA_Left, GA_Top, GA_Width and GA_Height placeholders in the
constructor tags if the gadget needs layout geometry. Show replaces only
tags already present; it does not append missing geometry or environment
tags. Later ordinary Set values are not merged into the constructor
clone: use Remember for values that must survive Hide/Show.
CloneTagItems failure and individual Remember allocation failures do not
fail wrapper construction. There is no complete gadget-creation or
remembered-state error report. Use a class that creates a gadget
suitable for AddGadget, not an arbitrary BOOPSI object. Keep callbacks
and event processing serialized with Hide and disposal.