Description:

Surrounds its child with a decorative frame and an optional label.

If present, the label is drawn inside the top edge of the frame. The horizontal position of the label can be controlled with [ method@Gtk.Frame.set_label_align].

`GtkFrame` clips its child. You can use this to add rounded corners to widgets, but be aware that it also cuts off shadows.

GtkFrame as GtkBuildable

An example of a UI definition fragment with GtkFrame:

```xml <object class="GtkFrame"> <property name="label-widget"> <object class="GtkLabel" id="frame_label"/> < /property> <property name="child"> <object class="GtkEntry" id="frame_content"/> </property> </object> ```

CSS nodes

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

`GtkFrame` 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.

Accessibility

`GtkFrame` uses the [enum@Gtk.AccessibleRole.group] role.

All known sub-classes:

AspectFrame

Namespace: Gtk

Package: gtk+-2.0

Content:

Properties:

public string label { get; set; }

Text of the frame's label.

public Widget label_widget { get; set; }

Widget to display in place of the usual frame label.

public float label_xalign { get; set; }

The horizontal alignment of the label.

public float label_yalign { get; set; }

public ShadowType shadow { get; set; }

public ShadowType shadow_type { get; set; }

Creation methods:

public Frame (string? label)

Creates a new `GtkFrame`, with optional label label.

Methods:

public virtual void compute_child_allocation (Allocation allocation)

public unowned string get_label ()

Returns the frame labels text.

public void get_label_align (out float xalign, out float yalign)

Retrieves the X alignment of the frame’s label.

public unowned Widget get_label_widget ()

Retrieves the label widget for the frame.

public ShadowType get_shadow_type ()

Retrieves the shadow type of the frame.

public void set_label (string label)

Creates a new `GtkLabel` with the label and sets it as the frame's label widget.

public void set_label_align (float xalign, float yalign)

Sets the X alignment of the frame widget’s label.

public void set_label_widget (Widget label_widget)

Sets the label widget for the frame.

public void set_shadow_type (ShadowType type)

Sets the shadow_type for this, i.

Fields:

Inherited Members:

All known members inherited from class Gtk.Bin

child

get_child

All known members inherited from class Gtk.Object

user_data

All known members inherited from interface Atk.Implementor

ref_accessible

Frame

Object Hierarchy: