Package: gtk

Class gtk-button-box

Superclasses

gtk-box, gtk-container, gtk-widget, gtk-buildable, gtk-orientable, g-object, common-lisp:standard-object, common-lisp:t

Documented Subclasses

None

Direct Slots

layout-style
The layout-style property of type gtk-button-box-style (Read / Write)
How to lay out the buttons in the box.
Default value: :edge

Details

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
 

Slot Access Functions

Inherited Slot Access Functions

See also

2021-12-9