gtk.Frame a bin with a decorative frame and optional label. Synopsis gtk.Frame gtk.Bin gtk.Frame labelNone set_label label get_label set_label_widget label_widget get_label_widget set_label_align xalign yalign get_label_align set_shadow_type type get_shadow_type Ancestry +-- gobject.GObject +-- gtk.Object +-- gtk.Widget +-- gtk.Container +-- gtk.Bin +-- gtk.Frame Implemented Interfaces gtk.Frame implements gtk.Buildable gtk.Frame Properties gtk.Object Properties gtk.Widget Properties gtk.Container Properties
"label" Read-Write The text of the frame's label "label-widget" Read-Write The widget to display in place of the usual frame label. "label-xalign" Read-Write The horizontal alignment of the label widget in the range of 0.0 to 1.0 "label-yalign" Read-Write The vertical alignment of the decoration within the label widget height in the range of 0.0 to 1.0 "shadow-type" Read-Write The style of the frame's border; one of: gtk.SHADOW_NONE, gtk.SHADOW_IN, gtk.SHADOW_OUT, gtk.SHADOW_ETCHED_IN, gtk.SHADOW_ETCHED_OUT
gtk.Frame Style Properties gtk.Widget Style Properties gtk.Frame Signal Prototypes gobject.GObject Signal Prototypes gtk.Object Signal Prototypes gtk.Widget Signal Prototypes gtk.Container Signal Prototypes Description The gtk.Frame widget is a gtk.Bin 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 set_label_align(). Constructor gtk.Frame labelNone label : a string to use as the label text or None if no label is required. Returns : a new frame widget Creates a new gtk.Frame widget with the label text specified by label. If label is None no label is created. Methods gtk.Frame.set_label set_label label label : a string to be used as the label text The set_label() method sets the text of the label as specified by label. If label is None the current label is removed. gtk.Frame.get_label get_label Returns : the text in the label, or None if there is no label widget or the label widget is not a gtk.Label. The get_label() method returns the text in the label widget. If there is no label widget or the label widget is not a gtk.Label the method returns None. gtk.Frame.set_label_widget set_label_widget label_widget label_widget : the new label widget The set_label_widget() method set the label widget (usually to something other than a gtk.Label widget) for the frame. This widget will appear embedded in the top edge of the frame as a title. gtk.Frame.get_label_widget get_label_widget Returns : the label widget, or None if there is no label widget. The get_label_widget() method retrieves the label widget for the frame. See set_label_widget(). gtk.Frame.set_label_align set_label_align xalign yalign xalign : the horizontal alignment of the label widget along the top edge of the frame (in the range of 0.0 to 1.0) yalign : the vertical alignment of the decoration with respect to the label widget (in the range 0.0 to 1.0) The set_label_align() method sets the alignment of the frame's label widget and decoration (defaults are 0.0 and 0.5) as specified by xalign and yalign. The xalign value specifies the fraction of free horizontal space that is allocated to the left of the label widget. The yalign value specifies the fraction of label widget height above the decoration. gtk.Frame.get_label_align get_label_align Returns : a tuple containing the x and y alignments of the frame's label widget The get_label_align() method returns a tuple containing the X and Y alignment of the frame's label widget and decoration. See the set_label_align() method. gtk.Frame.set_shadow_type set_shadow_type type type : a shadow type: gtk.SHADOW_NONE, gtk.SHADOW_IN, gtk.SHADOW_OUT, gtk.SHADOW_ETCHED_IN, gtk.SHADOW_ETCHED_OUT The set_shadow_type() method sets the frame's shadow type to the value of type. The type must be one of: gtk.SHADOW_NONE, gtk.SHADOW_IN, gtk.SHADOW_OUT, gtk.SHADOW_ETCHED_IN, gtk.SHADOW_ETCHED_OUT gtk.Frame.get_shadow_type get_shadow_type Returns : the current shadow type of the frame. The get_shadow_type() method retrieves the shadow type of the frame; one of: gtk.SHADOW_NONE, gtk.SHADOW_IN, gtk.SHADOW_OUT, gtk.SHADOW_ETCHED_IN, gtk.SHADOW_ETCHED_OUT. See set_shadow_type().