GtkFrame: GTK+ 2 Reference Manual

## GtkFrame GtkFrame |

## Functions

GtkWidget * | gtk_frame_new ()
void | gtk_frame_set_label ()
void | gtk_frame_set_label_widget ()
void | gtk_frame_set_label_align ()
void | gtk_frame_set_shadow_type ()
const gchar * | gtk_frame_get_label ()
void | gtk_frame_get_label_align ()
GtkWidget * | gtk_frame_get_label_widget ()
GtkShadowType | gtk_frame_get_shadow_type ()

## Properties

char * | label | Read / Write
GtkWidget * | label-widget | Read / Write
float | label-xalign | Read / Write
float | label-yalign | Read / Write
GtkShadowType | shadow | Read / Write
GtkShadowType | shadow-type | Read / Write

## Types and Values

struct | GtkFrame

## Object Hierarchy

        GObject
        ╰── GInitiallyUnowned
            ╰── GtkObject
                ╰── GtkWidget
                    ╰── GtkContainer
                        ╰── GtkBin
                            ╰── GtkFrame
                                ╰── GtkAspectFrame

## Implemented Interfaces

GtkFrame implements AtkImplementorIface and GtkBuildable.

## Includes

    #include <gtk/gtk.h>

## Description

## Functions

### gtk_frame_new ()

    GtkWidget *
    gtk_frame_new (const gchar *label);

Creates a new GtkFrame, with optional label `label` . If `label` is `NULL`, the label is omitted.

#### Parameters

label | the text to use as the label of the frame |

#### Returns

a new GtkFrame widget

### gtk_frame_set_label ()

    void
    gtk_frame_set_label (GtkFrame *frame,
                         const gchar *label);

Sets the text of the label. If `label` is `NULL`, the current label is removed.

#### Parameters

frame | a GtkFrame |
label | the text to use as the label of the frame. | [allow-none]

### gtk_frame_set_label_widget ()

    void
    gtk_frame_set_label_widget (GtkFrame *frame,
                                GtkWidget *label_widget);

Sets the label widget for the frame. This is the widget that will appear embedded in the top edge of the frame as a title.

#### Parameters

frame | a GtkFrame |
label_widget | the new label widget |

### gtk_frame_set_label_align ()

    void
    gtk_frame_set_label_align (GtkFrame *frame,
                               gfloat xalign,
                               gfloat yalign);

Sets the alignment of the frame widget's label. The default values for a newly created frame are 0.0 and 0.5.

#### Parameters

frame | a GtkFrame |
xalign | The position of the label along the top edge of the widget. A value of 0.0 represents left alignment; 1.0 represents right alignment. |
yalign | The y alignment of the label. A value of 0.0 aligns under the frame; 1.0 aligns above the frame. If the values are exactly 0.0 or 1.0 the gap in the frame won't be painted because the label will be completely above or below the frame. |

### gtk_frame_set_shadow_type ()

    void
    gtk_frame_set_shadow_type (GtkFrame *frame,
                               GtkShadowType type);

Sets the shadow type for `frame` .

#### Parameters

frame | a GtkFrame |
type | the new GtkShadowType |

### gtk_frame_get_label ()

    const gchar *
    gtk_frame_get_label (GtkFrame *frame);

If the frame's label widget is a GtkLabel, returns the text in the label widget. (The frame will have a GtkLabel for the label widget if a non-`NULL` argument was passed to `gtk_frame_new()`.)

#### Parameters

frame | a GtkFrame |

#### Returns

the text in the label, or `NULL` if there was no label widget or the lable widget was not a GtkLabel. This string is owned by GTK+ and must not be modified or freed.

### gtk_frame_get_label_align ()

    void
    gtk_frame_get_label_align (GtkFrame *frame,
                               gfloat *xalign,
                               gfloat *yalign);

Retrieves the X and Y alignment of the frame's label. See `gtk_frame_set_label_align()`.

#### Parameters

frame | a GtkFrame |
xalign | location to store X alignment of frame's label, or `NULL`. | [out][allow-none]
yalign | location to store X alignment of frame's label, or `NULL`. | [out][allow-none]

### gtk_frame_get_label_widget ()

    GtkWidget *
    gtk_frame_get_label_widget (GtkFrame *frame);

Retrieves the label widget for the frame. See `gtk_frame_set_label_widget()`.

#### Parameters

frame | a GtkFrame |

#### Returns

the label widget, or `NULL` if there is none.

[transfer none]

### gtk_frame_get_shadow_type ()

    GtkShadowType
    gtk_frame_get_shadow_type (GtkFrame *frame);

Retrieves the shadow type of the frame. See `gtk_frame_set_shadow_type()`.

#### Parameters

frame | a GtkFrame |

#### Returns

the current shadow type of the frame.

## Types and Values

### struct GtkFrame

    struct GtkFrame;

## Property Details

### The `“label”` property

      “label”                    char *

Text of the frame's label.

Owner: GtkFrame

Flags: Read / Write

Default value: NULL

### The `“label-widget”` property

      “label-widget”             GtkWidget *

A widget to display in place of the usual frame label.

Owner: GtkFrame

Flags: Read / Write

### The `“label-xalign”` property

      “label-xalign”             float

The horizontal alignment of the label.

Owner: GtkFrame

Flags: Read / Write

Allowed values: [0,1]

Default value: 0

### The `“label-yalign”` property

      “label-yalign”             float

The vertical alignment of the label.

Owner: GtkFrame

Flags: Read / Write

Allowed values: [0,1]

Default value: 0.5

### The `“shadow”` property

      “shadow”                   GtkShadowType

Deprecated property, use shadow_type instead.

Owner: GtkFrame

Flags: Read / Write

Default value: GTK_SHADOW_ETCHED_IN

### The `“shadow-type”` property

      “shadow-type”              GtkShadowType

Appearance of the frame border.

Owner: GtkFrame

Flags: Read / Write

Default value: GTK_SHADOW_ETCHED_IN