gtk:widget, gobject:initially-unowned, gtk:accessible, gtk:buildable, gtk:constraint-target, gobject:object, common-lisp:standard-object, common-lisp:t

None

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

Figure: GtkFrame

If present, the label is drawn inside the top edge of the frame. The horizontal position of the label can be controlled with the gtk:frame-label-xalign function.

The gtk:frame widget clips its child widget. You can use this to add rounded corners to widgets, but be aware that it also cuts off shadows. See the gtk:aspect-frame widget for a frame that constrains its child to a particular aspect ratio. 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 a gtk:frame widget

<object class="GtkFrame">
 <child type="label">
   <object class="GtkLabel" id="frame-label"/>
 </child>
 <child>
   <object class="GtkEntry" id="frame-content"/>
 </child>
</object>    

frame
├── <label widget>
╰── <child>    

The gtk:frame implementation has a main CSS node with name frame, which is used to draw the visible border. You can set the appearance of the border using CSS properties like border-style on this node.