Gnome::Gtk4::CenterBox
#------------------------------------------------------------------------------- #--[Class Description]---------------------------------------------------------- #-------------------------------------------------------------------------------
=begin rakudoc
Description
Gnome::Gtk4::CenterBox arranges three children in a row, keeping the middle child centered as well as possible.
To add children to Gnome::Gtk4::CenterBox, use .set-start-widget(), .set-center-widget() and .set-end-widget().
The sizing and positioning of children can be influenced with the align and expand properties of the children.
GtkCenterBox as GtkBuildable
The Gnome::Gtk4::CenterBox implementation of the Gnome::Gtk4::R-Buildable interface supports placing children in the 3 positions by specifying “start”, “center” or “end” as the “type” attribute of a `<child>` element.
CSS nodes
Gnome::Gtk4::CenterBox uses a single CSS node with the name “box”,
The first child of the Gnome::Gtk4::CenterBox will be allocated depending on the text direction, i.e. in left-to-right layouts it will be allocated on the left and in right-to-left layouts on the right.
In vertical orientation, the nodes of the children are arranged from top to bottom.
Accessibility
Until GTK 4.10, Gnome::Gtk4::CenterBox used the GTK_ACCESSIBLE_ROLE_GROUP role.
Starting from GTK 4.12, Gnome::Gtk4::CenterBox uses the GTK_ACCESSIBLE_ROLE_GENERIC role.
Uml Diagram
=end rakudoc
#------------------------------------------------------------------------------- #--[Class Initialization]------------------------------------------------------- #-------------------------------------------------------------------------------
=begin rakudoc
Class initialization
new
:native-object
Create an object using a native object from an object of the same type found elsewhere. See also Gnome::N::TopLevelSupportClass.
multi method new ( N-Object() :$native-object! )
=end rakudoc
#------------------------------------------------------------------------------- =begin rakudoc
new-centerbox
Creates a new Gnome::Gtk4::CenterBox.
method new-centerbox ( --> Gnome::Gtk4::CenterBox )
=end rakudoc
#------------------------------------------------------------------------------- #--[Methods]-------------------------------------------------------------------- #-------------------------------------------------------------------------------
=begin rakudoc
Methods =end rakudoc
#------------------------------------------------------------------------------- =begin rakudoc
get-baseline-position
Gets the value set by .set-baseline-position().
method get-baseline-position (--> GtkBaselinePosition )
Return value; the baseline position.
=end rakudoc
#------------------------------------------------------------------------------- =begin rakudoc
get-center-widget
Gets the center widget, or undefined if there is none.
method get-center-widget (--> N-Object )
Return value; the center widget..
=end rakudoc
#------------------------------------------------------------------------------- =begin rakudoc
get-end-widget
Gets the end widget, or undefined if there is none.
method get-end-widget (--> N-Object )
Return value; the end widget..
=end rakudoc
#------------------------------------------------------------------------------- =begin rakudoc
get-shrink-center-last
Gets whether $self shrinks the center widget after other children.
method get-shrink-center-last (--> Bool )
Return value; whether to shrink the center widget after others.
=end rakudoc
#------------------------------------------------------------------------------- =begin rakudoc
get-start-widget
Gets the start widget, or undefined if there is none.
method get-start-widget (--> N-Object )
Return value; the start widget..
=end rakudoc
#------------------------------------------------------------------------------- =begin rakudoc
set-baseline-position
Sets the baseline position of a center box.
This affects only horizontal boxes with at least one baseline
aligned child. If there is more vertical space available than
requested, and the baseline is not allocated by the parent then $position is used to allocate the baseline wrt. the extra space
available.
method set-baseline-position ( GtkBaselinePosition $position )
$position; a
enumeration GtkBaselinePosition defined in Gnome::Gtk4::T-enums.
=end rakudoc
#------------------------------------------------------------------------------- =begin rakudoc
set-center-widget
Sets the center widget.
To remove the existing center widget, pass undefined.
method set-center-widget ( N-Object() $child )
$child; the new center widget.
=end rakudoc
#------------------------------------------------------------------------------- =begin rakudoc
set-end-widget
Sets the end widget.
To remove the existing end widget, pass undefined.
method set-end-widget ( N-Object() $child )
$child; the new end widget.
=end rakudoc
#------------------------------------------------------------------------------- =begin rakudoc
set-shrink-center-last
Sets whether to shrink the center widget after other children.
By default, when there's no space to give all three children their natural widths, the start and end widgets start shrinking and the center child keeps natural width until they reach minimum width.
If set to False, start and end widgets keep natural width and the
center widget starts shrinking instead.
method set-shrink-center-last ( Bool() $shrink-center-last )
$shrink-center-last; whether to shrink the center widget after others.
=end rakudoc
#------------------------------------------------------------------------------- =begin rakudoc
set-start-widget
Sets the start widget.
To remove the existing start widget, pass undefined.
method set-start-widget ( N-Object() $child )
$child; the new start widget.
=end rakudoc