These widgets can be used to create empty space within a dialog to avoid widgets being cramped together - purely for aesthetical reasons. There is no functionality attached.
Do not try to use spacings with excessive sizes to create layouts! This is very likely to work for just one UI. Use spacings only to separate widgets from each other or from dialog borders. For other purposes, use `HWeight
and `VWeight
and describe the dialog logically rather than physically.
The size
given is measured in units roughly equivalent to the size of a character in the respective UI. Fractional numbers can be used here, but text based UIs may choose to round the number as appropriate - even if this means simply ignoring a spacing when its size becomes zero.
If size
is omitted, it defaults to 1. HSpacing
will create a horizontal spacing with default width and zero height. VSpacing
will create a vertical spacing with default height and zero width.
With options hstretch
or vstretch
, the spacing will at least take the amount of space specified with size
, but it will be stretchable in the respective dimension. Thus, `HSpacing( `opt( `hstretch )
is equivalent to `HBox( `HSpacing( 0.5 ), `HSpacing( 0.5 ) )