DreamGUI
The .dui Language

Slot lines and components

Telling the parent panel where a node goes with @slot and @fill, and attaching behaviours, layout containers and layout-self objects with + Class.

Slot lines: @slot and @fill

A widget inside a panel -- a parent whose container lays children out (a box, a grid, an overlay) -- has a panel slot: how the parent places it. @slot lines set it:

Text Label {
    @slot HorizontalAlignment = Fill
    @slot Padding = (0, 4, 0, 4)
}

Several at once go in a block, with the property syntax of a + block:

@slot { SizeRule = Fill  Padding = (0, 8, 0, 0) }

And the two lines a box layout is mostly made of have a shorthand:

ShorthandStands for
@fill@slot SizeRule = Fill
@fill 2@slot SizeRule = Fill and @slot FillWeight = 2

@fill stands alone on its line, or with its weight and nothing else. A slot line on a node whose parent lays out no panel is DUI5003.

@slot Size

A box that is exactly one size is the other common slot line, and it has a shorthand too:

@slot Size = (120, 48)
@slot { Size = (120, 48)  Padding = (4, 0, 4, 0) }

Size stands for @slot MinDesiredSize and @slot MaxDesiredSize given the same value, so the slot is held at that size on both axes. It reads in a @slot { … } block and in a style's slot lines as it does on its own line. Only = gives it a value: @slot Size <- Function() is DUI4001, whose message names the two properties to bind separately, MinDesiredSize and MaxDesiredSize.

Components: + Class

+ Class { … } attaches a behaviour, a layout container or a layout-self object to the node, and its block sets that object's properties:

Widget Confirm {
    + UIButton { TransitionType = None }
    + VerticalBox { Spacing = 10  Padding = (24, 28, 24, 28) }
}

The class is found by its name with the plugin's prefixes tried: VerticalBox finds the vertical box container, UIButton the button behaviour, Button too. A full /Script/Module.Class path works as well. A name that resolves to nothing a widget can carry is DUI3006.

A node has one layout container. + VerticalBox on a plain Widget and a container type are two ways to write the same thing; the type is shorter.

On this page