gi-gtk-4.0.4: Gtk bindings
CopyrightWill Thompson Iñaki García Etxebarria and Jonas Platte
LicenseLGPL-2.1
MaintainerIñaki García Etxebarria
Safe HaskellSafe-Inferred
LanguageHaskell2010

GI.Gtk.Objects.AspectFrame

Description

GtkAspectFrame is useful when you want pack a widget so that it can resize while retaining the same aspect ratio. For instance, one might be drawing a small preview of a larger image.

The frame can respect the aspect ratio of the child widget, or use its own aspect ratio.

CSS nodes

GtkAspectFrame uses a CSS node with name frame.

Synopsis

Exported types

newtype AspectFrame Source #

Memory-managed wrapper type.

Constructors

AspectFrame (ManagedPtr AspectFrame) 

Instances

Instances details
Eq AspectFrame Source # 
Instance details

Defined in GI.Gtk.Objects.AspectFrame

GObject AspectFrame Source # 
Instance details

Defined in GI.Gtk.Objects.AspectFrame

ManagedPtrNewtype AspectFrame Source # 
Instance details

Defined in GI.Gtk.Objects.AspectFrame

Methods

toManagedPtr :: AspectFrame -> ManagedPtr AspectFrame

TypedObject AspectFrame Source # 
Instance details

Defined in GI.Gtk.Objects.AspectFrame

Methods

glibType :: IO GType

HasParentTypes AspectFrame Source # 
Instance details

Defined in GI.Gtk.Objects.AspectFrame

IsGValue (Maybe AspectFrame) Source #

Convert AspectFrame to and from GValue. See toGValue and fromGValue.

Instance details

Defined in GI.Gtk.Objects.AspectFrame

Methods

gvalueGType_ :: IO GType

gvalueSet_ :: Ptr GValue -> Maybe AspectFrame -> IO ()

gvalueGet_ :: Ptr GValue -> IO (Maybe AspectFrame)

type ParentTypes AspectFrame Source # 
Instance details

Defined in GI.Gtk.Objects.AspectFrame

class (GObject o, IsDescendantOf AspectFrame o) => IsAspectFrame o Source #

Type class for types which can be safely cast to AspectFrame, for instance with toAspectFrame.

Instances

Instances details
(GObject o, IsDescendantOf AspectFrame o) => IsAspectFrame o Source # 
Instance details

Defined in GI.Gtk.Objects.AspectFrame

toAspectFrame :: (MonadIO m, IsAspectFrame o) => o -> m AspectFrame Source #

Cast to AspectFrame, for types for which this is known to be safe. For general casts, use castTo.

Methods

Click to display all available methods, including inherited ones

Expand

Methods

actionSetEnabled, activate, activateAction, activateDefault, addController, addCssClass, addMnemonicLabel, addTickCallback, allocate, bindProperty, bindPropertyFull, childFocus, computeBounds, computeExpand, computePoint, computeTransform, contains, createPangoContext, createPangoLayout, dragCheckThreshold, errorBell, forceFloating, freezeNotify, getv, grabFocus, hasCssClass, hasDefault, hasFocus, hasVisibleFocus, hide, inDestruction, initTemplate, insertActionGroup, insertAfter, insertBefore, isAncestor, isDrawable, isFloating, isFocus, isSensitive, isVisible, keynavFailed, listMnemonicLabels, map, measure, mnemonicActivate, notify, notifyByPspec, observeChildren, observeControllers, pick, queueAllocate, queueDraw, queueResize, realize, ref, refSink, removeController, removeCssClass, removeMnemonicLabel, removeTickCallback, resetProperty, resetRelation, resetState, runDispose, shouldLayout, show, sizeAllocate, snapshotChild, stealData, stealQdata, thawNotify, translateCoordinates, triggerTooltipQuery, unmap, unparent, unrealize, unref, unsetStateFlags, updateProperty, updateRelation, updateState, watchClosure.

Getters

getAccessibleRole, getAllocatedBaseline, getAllocatedHeight, getAllocatedWidth, getAllocation, getAncestor, getBuildableId, getCanFocus, getCanTarget, getChild, getChildVisible, getClipboard, getCssClasses, getCssName, getCursor, getData, getDirection, getDisplay, getFirstChild, getFocusChild, getFocusOnClick, getFocusable, getFontMap, getFontOptions, getFrameClock, getHalign, getHasTooltip, getHeight, getHexpand, getHexpandSet, getLastChild, getLayoutManager, getMapped, getMarginBottom, getMarginEnd, getMarginStart, getMarginTop, getName, getNative, getNextSibling, getObeyChild, getOpacity, getOverflow, getPangoContext, getParent, getPreferredSize, getPrevSibling, getPrimaryClipboard, getProperty, getQdata, getRatio, getRealized, getReceivesDefault, getRequestMode, getRoot, getScaleFactor, getSensitive, getSettings, getSize, getSizeRequest, getStateFlags, getStyleContext, getTemplateChild, getTooltipMarkup, getTooltipText, getValign, getVexpand, getVexpandSet, getVisible, getWidth, getXalign, getYalign.

Setters

setCanFocus, setCanTarget, setChild, setChildVisible, setCssClasses, setCursor, setCursorFromName, setData, setDataFull, setDirection, setFocusChild, setFocusOnClick, setFocusable, setFontMap, setFontOptions, setHalign, setHasTooltip, setHexpand, setHexpandSet, setLayoutManager, setMarginBottom, setMarginEnd, setMarginStart, setMarginTop, setName, setObeyChild, setOpacity, setOverflow, setParent, setProperty, setRatio, setReceivesDefault, setSensitive, setSizeRequest, setStateFlags, setTooltipMarkup, setTooltipText, setValign, setVexpand, setVexpandSet, setVisible, setXalign, setYalign.

getChild

aspectFrameGetChild Source #

Arguments

:: (HasCallStack, MonadIO m, IsAspectFrame a) 
=> a

self: a AspectFrame

-> m (Maybe Widget)

Returns: the child widget of self@

Gets the child widget of self.

getObeyChild

aspectFrameGetObeyChild Source #

Arguments

:: (HasCallStack, MonadIO m, IsAspectFrame a) 
=> a

self: a AspectFrame

-> m Bool

Returns: whether to obey the child's size request

Returns whether the child's size request should override the set aspect ratio of the AspectFrame.

getRatio

aspectFrameGetRatio Source #

Arguments

:: (HasCallStack, MonadIO m, IsAspectFrame a) 
=> a

self: a AspectFrame

-> m Float

Returns: the desired aspect ratio

Returns the desired aspect ratio of the child set using aspectFrameSetRatio.

getXalign

aspectFrameGetXalign Source #

Arguments

:: (HasCallStack, MonadIO m, IsAspectFrame a) 
=> a

self: a AspectFrame

-> m Float

Returns: the horizontal alignment

Returns the horizontal alignment of the child within the allocation of the AspectFrame.

getYalign

aspectFrameGetYalign Source #

Arguments

:: (HasCallStack, MonadIO m, IsAspectFrame a) 
=> a

self: a AspectFrame

-> m Float

Returns: the vertical alignment

Returns the vertical alignment of the child within the allocation of the AspectFrame.

new

aspectFrameNew Source #

Arguments

:: (HasCallStack, MonadIO m) 
=> Float

xalign: Horizontal alignment of the child within the allocation of the AspectFrame. This ranges from 0.0 (left aligned) to 1.0 (right aligned)

-> Float

yalign: Vertical alignment of the child within the allocation of the AspectFrame. This ranges from 0.0 (top aligned) to 1.0 (bottom aligned)

-> Float

ratio: The desired aspect ratio.

-> Bool

obeyChild: If True, ratio is ignored, and the aspect ratio is taken from the requistion of the child.

-> m AspectFrame

Returns: the new AspectFrame.

Create a new AspectFrame.

setChild

aspectFrameSetChild Source #

Arguments

:: (HasCallStack, MonadIO m, IsAspectFrame a, IsWidget b) 
=> a

self: a AspectFrame

-> Maybe b

child: the child widget

-> m () 

Sets the child widget of self.

setObeyChild

aspectFrameSetObeyChild Source #

Arguments

:: (HasCallStack, MonadIO m, IsAspectFrame a) 
=> a

self: a AspectFrame

-> Bool

obeyChild: If True, ratio is ignored, and the aspect ratio is taken from the requistion of the child.

-> m () 

Sets whether the aspect ratio of the child's size request should override the set aspect ratio of the AspectFrame.

setRatio

aspectFrameSetRatio Source #

Arguments

:: (HasCallStack, MonadIO m, IsAspectFrame a) 
=> a

self: a AspectFrame

-> Float

ratio: aspect ratio of the child

-> m () 

Sets the desired aspect ratio of the child.

setXalign

aspectFrameSetXalign Source #

Arguments

:: (HasCallStack, MonadIO m, IsAspectFrame a) 
=> a

self: a AspectFrame

-> Float

xalign: horizontal alignment, from 0.0 (left aligned) to 1.0 (right aligned)

-> m () 

Sets the horizontal alignment of the child within the allocation of the AspectFrame.

setYalign

aspectFrameSetYalign Source #

Arguments

:: (HasCallStack, MonadIO m, IsAspectFrame a) 
=> a

self: a AspectFrame

-> Float

yalign: horizontal alignment, from 0.0 (top aligned) to 1.0 (bottom aligned)

-> m () 

Sets the vertical alignment of the child within the allocation of the AspectFrame.

Properties

child

The child widget of the AspectFrame.

clearAspectFrameChild :: (MonadIO m, IsAspectFrame o) => o -> m () Source #

Set the value of the “child” property to Nothing. When overloading is enabled, this is equivalent to

clear #child

constructAspectFrameChild :: (IsAspectFrame o, MonadIO m, IsWidget a) => a -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “child” property. This is rarely needed directly, but it is used by new.

getAspectFrameChild :: (MonadIO m, IsAspectFrame o) => o -> m (Maybe Widget) Source #

Get the value of the “child” property. When overloading is enabled, this is equivalent to

get aspectFrame #child

setAspectFrameChild :: (MonadIO m, IsAspectFrame o, IsWidget a) => o -> a -> m () Source #

Set the value of the “child” property. When overloading is enabled, this is equivalent to

set aspectFrame [ #child := value ]

obeyChild

Whether the AspectFrame should use the aspect ratio of its AspectFrame:child widget.

constructAspectFrameObeyChild :: (IsAspectFrame o, MonadIO m) => Bool -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “obey-child” property. This is rarely needed directly, but it is used by new.

getAspectFrameObeyChild :: (MonadIO m, IsAspectFrame o) => o -> m Bool Source #

Get the value of the “obey-child” property. When overloading is enabled, this is equivalent to

get aspectFrame #obeyChild

setAspectFrameObeyChild :: (MonadIO m, IsAspectFrame o) => o -> Bool -> m () Source #

Set the value of the “obey-child” property. When overloading is enabled, this is equivalent to

set aspectFrame [ #obeyChild := value ]

ratio

The aspect ratio to be used by the AspectFrame.

This property is only used if AspectFrame:obey-child is set to False.

constructAspectFrameRatio :: (IsAspectFrame o, MonadIO m) => Float -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “ratio” property. This is rarely needed directly, but it is used by new.

getAspectFrameRatio :: (MonadIO m, IsAspectFrame o) => o -> m Float Source #

Get the value of the “ratio” property. When overloading is enabled, this is equivalent to

get aspectFrame #ratio

setAspectFrameRatio :: (MonadIO m, IsAspectFrame o) => o -> Float -> m () Source #

Set the value of the “ratio” property. When overloading is enabled, this is equivalent to

set aspectFrame [ #ratio := value ]

xalign

The horizontal alignment of the AspectFrame:child widget of the aspect frame.

constructAspectFrameXalign :: (IsAspectFrame o, MonadIO m) => Float -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “xalign” property. This is rarely needed directly, but it is used by new.

getAspectFrameXalign :: (MonadIO m, IsAspectFrame o) => o -> m Float Source #

Get the value of the “xalign” property. When overloading is enabled, this is equivalent to

get aspectFrame #xalign

setAspectFrameXalign :: (MonadIO m, IsAspectFrame o) => o -> Float -> m () Source #

Set the value of the “xalign” property. When overloading is enabled, this is equivalent to

set aspectFrame [ #xalign := value ]

yalign

The vertical alignment of the AspectFrame:child widget of the aspect frame.

constructAspectFrameYalign :: (IsAspectFrame o, MonadIO m) => Float -> m (GValueConstruct o) Source #

Construct a GValueConstruct with valid value for the “yalign” property. This is rarely needed directly, but it is used by new.

getAspectFrameYalign :: (MonadIO m, IsAspectFrame o) => o -> m Float Source #

Get the value of the “yalign” property. When overloading is enabled, this is equivalent to

get aspectFrame #yalign

setAspectFrameYalign :: (MonadIO m, IsAspectFrame o) => o -> Float -> m () Source #

Set the value of the “yalign” property. When overloading is enabled, this is equivalent to

set aspectFrame [ #yalign := value ]