A
gtk-button-box widget should be used to provide a consistent layout
of buttons throughout your application.
The layout/spacing can be altered by the programmer, or if desired, by the
user to alter the 'feel' of a program to a small degree.
The
gtk-button-box-layout-style slot access function retrieves and
alters the method used to spread the buttons in a button box across the
container.
The main purpose of the
gtk-button-box widget is to make sure the children have all the same size. The
gtk-button-box widget gives all
children the same size, but it does allow 'outliers' to keep their own larger
size.
To excempt individual children from homogeneous sizing regardless of their 'outlier' status, you can set the
non-homogeneous child property.
CSS nodes
The
gtk-button-box widget uses a single CSS node with name
buttonbox.
Child Property Details
- non-homogeneous
- The non-homogeneous child property of type :boolean (Read / Write)
If true, the child widget will not be subject to homogeneous sizing.
Default value: false - secondary
- The secondary child property of type :boolean (Read / Write)
If true, the child widget appears in a secondary group of children, suitable for, e.g. help buttons.
Default value: false
Style Property Details
- child-internal-pad-x
- The child-internal-pad-x style property of type :int (Read)
Amount to increase size of the child widget on either side.
Warning: The child-internal-pad-x style property has been
deprecated since version 3.20 and should not be used in newly written code. Use CSS padding instead.
Allowed values: >= 0
Default value: 4 - child-internal-pad-y
- The child-internal-pad-y style property of type :int (Read)
Amount to increase the size of the child widget on the top and bottom.
Warning: The child-internal-pad-y style property has been
deprecated since version 3.20 and should not be used in newly written code. Use CSS padding instead.
Allowed values: >= 0
Default value: 0 - child-min-height
- The child-min-height style property of type :int (Read)
Minimum height of buttons inside the box.
Warning: The child-min-height style property has been
deprecated since version 3.20 and should not be used in newly written code. Use CSS padding instead.
Allowed values: >= 0
Default value: 27 - child-min-width
- The child-min-width style property of type :int (Read)
Minimum width of buttons inside the box.
Warning: The child-min-width style property has been
deprecated since version 3.20 and should not be used in newly written code. Use CSS padding instead.
Allowed values: >= 0
Default value: 85