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

Frameadjust.mui

MUIA_Frameadjust_Spec

Function

Initialize the editor or retrieve its current serialized frame.

Inputs

Initialize and get, NUL-terminated frame-specification string. No local
setter. With no tag the stored fields are zero.

Notes

Construction parses values and initializes preview/controls without
retaining the input pointer. Validation failure is ignored and can
partially change fields. Get writes six or eight characters to embedded
storage and returns its borrowed pointer with TRUE. The pointer lasts
until disposal and is overwritten by later Get. Editing changes stored
fields through internal hooks, without publishing this attribute as a
notification. Control ranges can differ from the parser ranges; see the
class contract.

MUIC_Frameadjust

Superclass

Group.mui

Description

Edit a frame through preview buttons, four spacing sliders and
rounded-frame controls. Group owns its children and embedded hooks.
Construction returns NULL on superclass construction failure; later
preview creation, insertion and notification registration results are
not comprehensively checked. No local Dispose or Set override exists.
Spacing sliders range from zero to nine. Rounded radius ranges zero to
fifteen, default five; width ranges one to five, default one. Stored
frame fields initially remain zero unless Spec is supplied; control
defaults alone do not set rounded frame fields.

Methods

Changing top spacing also sets bottom to the same value without its
notification; changing left also sets right. Bottom and right changes
are independent. These hooks update internal fields and the preview, not
a Frameadjust_Spec notification.
Enabling rounded mode sets type FST_ROUNDED and copies radius/width
controls. Disabling it changes a currently rounded type to numeric type
two and clears radius/width. Adjusting radius/width while rounded mode
is disabled also follows that clearing path. Clicking a frame sample
replaces type/state but leaves optional radius/width fields and checkbox
state unchanged.
Sample buttons include types zero through ten in normal state and one
through ten in selected state. Custom sample loops include types twelve
through twenty-two and twenty through twenty-four in both states,
duplicating twenty through twenty-two; they do not include
twenty-five/twenty-six. Type eleven is configured through rounded
controls.

Notes

Spec is initialize/get only. The constructor parses its string and sets
preview/control values before registering change notifications. It
ignores parser failure; partial parsed state is possible. Margins above
nine and widths outside one..five can remain in parsed fields while
their sliders clamp, until later interaction rewrites them. Repeated
Spec tags can leave previous control state where fields are not
explicitly reset.
Get serializes stored fields to a borrowed instance buffer; it does not
read controls anew. There is no local setter to reload Spec after
construction and no automatic Spec-change notification. Preserve the
built-in child/hook arrangement. Frame encoding and parser limitations
are those documented by Framedisplay.