Package: gtk

Class gtk-frame


gtk-bin, gtk-container, gtk-widget, g-initially-unowned, gtk-buildable, g-object, common-lisp:standard-object, common-lisp:t

Documented Subclasses

Direct Slots

The label property of type :string (Read / Write)
Text of the frame's label.
Default value: nil
The label-widget property of type gtk-widget (Read / Write)
A widget to display in place of the usual frame label.
The label-xalign property of type :float (Read / Write)
The horizontal alignment of the label.
Allowed values: [0,1]
Default value: 0
The label-yalign property of type :float (Read / Write)
The vertical alignment of the label.
Allowed values: [0,1]
Default value: 0.5
The shadow-type property of type gtk-shadow-type (Read / Write)
Appearance of the frame border.
Default value: :etched-in


The frame widget is a gtk-bin widget that surrounds its child with a decorative frame and an optional label.

If present, the label is drawn in a gap in the top side of the frame. The position of the label can be controlled with the gtk-frame-set-label-align function.

GtkFrame as GtkBuildable

The gtk-frame implementation of the gtk-buildable interface supports placing a child in the label position by specifying "label" as the type attribute of a <child> element. A normal content child can be specified without specifying a <child> type attribute.

Example: A UI definition fragment with gtk-frame
 <object class="GtkFrame">
  <child type="label">
    <object class="GtkLabel" id="frame-label"/>
    <object class="GtkEntry" id="frame-content"/>

CSS nodes

 ├── border[.flat]
 ├── <label widget>
 ╰── <child>    
gtk-frame has a main CSS node named frame and a subnode named border. The border node is used to draw the visible border. You can set the appearance of the border using CSS properties like border-style on the border node.

The border node can be given the style class .flat, which is used by themes to disable drawing of the border. To do this from code, call the gtk-frame-shadow-type slot access function with :none to add the .flat class or any other shadow type to remove it.

Slot Access Functions

Inherited Slot Access Functions

See also