GI.Gtk.Objects.Frame

The frame widget is a 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 frameSetLabelAlign.

GtkFrame as GtkBuildable

The GtkFrame implementation of the GtkBuildable 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.

An example of a UI definition fragment with GtkFrame: > >class="GtkFrame" > type="label" > class="GtkLabel" id="frame-label"/ > /child > child > class="GtkEntry" id="frame-content"/ > /child >/object

CSS nodes

plain code

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

GtkFrame has a main CSS node with name frame and a subnode with name border. The border node is used to render the visible border.

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 frameSetShadowType with GTK_SHADOW_NONE to add the .flat class or any other shadow type to remove it.

Exported types

newtype Frame

Constructors

Frame (ManagedPtr Frame)

Instances

GObject Frame

Methods

gobjectType :: Frame -> IO GType

IsImplementorIface Frame

IsObject Frame

IsWidget Frame

IsFrame Frame

IsContainer Frame

IsBin Frame

IsBuildable Frame

class GObject o => IsFrame o

Instances

(GObject a, UnknownAncestorError Constraint Frame a) => IsFrame a

IsFrame Frame

IsFrame AspectFrame

toFrame :: (MonadIO m, IsFrame o) => o -> m Frame

noFrame :: Maybe Frame

Methods

getLabel

frameGetLabel

Arguments

:: (HasCallStack, MonadIO m, IsFrame a)

=> a

frame: a Frame

-> m (Maybe Text)

Returns: the text in the label, or Nothing if there was no label widget or the lable widget was not a Label. This string is owned by GTK+ and must not be modified or freed.

If the frame’s label widget is a Label, returns the text in the label widget. (The frame will have a Label for the label widget if a non-Nothing argument was passed to frameNew.)

getLabelAlign

frameGetLabelAlign

Arguments

:: (HasCallStack, MonadIO m, IsFrame a)

=> a

frame: a Frame

-> m (Float, Float)

Retrieves the X and Y alignment of the frame’s label. See frameSetLabelAlign.

getLabelWidget

frameGetLabelWidget

Arguments

:: (HasCallStack, MonadIO m, IsFrame a)

=> a

frame: a Frame

-> m (Maybe Widget)

Returns: the label widget, or Nothing if there is none.

Retrieves the label widget for the frame. See frameSetLabelWidget.

getShadowType

frameGetShadowType

Arguments

:: (HasCallStack, MonadIO m, IsFrame a)

=> a

frame: a Frame

-> m ShadowType

Returns: the current shadow type of the frame.

Retrieves the shadow type of the frame. See frameSetShadowType.

new

frameNew

Arguments

:: (HasCallStack, MonadIO m)

=> Maybe Text

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

-> m Frame

Returns: a new Frame widget

Creates a new Frame, with optional label label. If label is Nothing, the label is omitted.

setLabel

frameSetLabel

Arguments

:: (HasCallStack, MonadIO m, IsFrame a)

=> a

frame: a Frame

-> Maybe Text

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

-> m ()

Removes the current Frame:label-widget. If label is not Nothing, creates a new Label with that text and adds it as the Frame:label-widget.

setLabelAlign

frameSetLabelAlign

Arguments

:: (HasCallStack, MonadIO m, IsFrame a)

=> a

frame: a Frame

-> Float

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.

-> Float

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.

-> m ()

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

setLabelWidget

frameSetLabelWidget

Arguments

:: (HasCallStack, MonadIO m, IsFrame a, IsWidget b)

=> a

frame: a Frame

-> Maybe b

labelWidget: the new label widget

-> m ()

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

setShadowType

frameSetShadowType

Arguments

:: (HasCallStack, MonadIO m, IsFrame a)

=> a

frame: a Frame

-> ShadowType

type: the new ShadowType

-> m ()

Sets the Frame:shadow-type for frame, i.e. whether it is drawn without (GTK_SHADOW_NONE) or with (other values) a visible border. Values other than GTK_SHADOW_NONE are treated identically by Frame. The chosen type is applied by removing or adding the .flat class to the CSS node named border.

Properties

label

clearFrameLabel :: (MonadIO m, IsFrame o) => o -> m ()

constructFrameLabel :: IsFrame o => Text -> IO (GValueConstruct o)

getFrameLabel :: (MonadIO m, IsFrame o) => o -> m (Maybe Text)

setFrameLabel :: (MonadIO m, IsFrame o) => o -> Text -> m ()

labelWidget

clearFrameLabelWidget :: (MonadIO m, IsFrame o) => o -> m ()

constructFrameLabelWidget :: (IsFrame o, IsWidget a) => a -> IO (GValueConstruct o)

getFrameLabelWidget :: (MonadIO m, IsFrame o) => o -> m (Maybe Widget)

setFrameLabelWidget :: (MonadIO m, IsFrame o, IsWidget a) => o -> a -> m ()

labelXalign

constructFrameLabelXalign :: IsFrame o => Float -> IO (GValueConstruct o)

getFrameLabelXalign :: (MonadIO m, IsFrame o) => o -> m Float

setFrameLabelXalign :: (MonadIO m, IsFrame o) => o -> Float -> m ()

labelYalign

constructFrameLabelYalign :: IsFrame o => Float -> IO (GValueConstruct o)

getFrameLabelYalign :: (MonadIO m, IsFrame o) => o -> m Float

setFrameLabelYalign :: (MonadIO m, IsFrame o) => o -> Float -> m ()

shadowType

constructFrameShadowType :: IsFrame o => ShadowType -> IO (GValueConstruct o)

getFrameShadowType :: (MonadIO m, IsFrame o) => o -> m ShadowType

setFrameShadowType :: (MonadIO m, IsFrame o) => o -> ShadowType -> m ()