Copyright | Will Thompson and Iñaki García Etxebarria |
---|---|
License | LGPL-2.1 |
Maintainer | Iñaki García Etxebarria |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
GI.Adw.Objects.OverlaySplitView
Contents
- Exported types
- Methods
- getCollapsed
- getContent
- getEnableHideGesture
- getEnableShowGesture
- getMaxSidebarWidth
- getMinSidebarWidth
- getPinSidebar
- getShowSidebar
- getSidebar
- getSidebarPosition
- getSidebarWidthFraction
- getSidebarWidthUnit
- new
- setCollapsed
- setContent
- setEnableHideGesture
- setEnableShowGesture
- setMaxSidebarWidth
- setMinSidebarWidth
- setPinSidebar
- setShowSidebar
- setSidebar
- setSidebarPosition
- setSidebarWidthFraction
- setSidebarWidthUnit
- Properties
Description
A widget presenting sidebar and content side by side or as an overlay.
<picture> <source srcset="overlay-split-view-dark.png" media="(prefers-color-scheme: dark)"> <img src="overlay-split-view.png" alt="overlay-split-view"> </picture> <picture> <source srcset="overlay-split-view-collapsed-dark.png" media="(prefers-color-scheme: dark)"> <img src="overlay-split-view-collapsed.png" alt="overlay-split-view-collapsed"> </picture>
AdwOverlaySplitView
has two children: sidebar and content, and displays
them side by side.
When [propertyoverlaySplitView
:collapsed] is set to TRUE
, the sidebar is
instead shown as an overlay above the content widget.
The sidebar can be hidden or shown using the
[propertyoverlaySplitView
:show-sidebar] property.
Sidebar can be displayed before or after the content, this can be controlled
with the [propertyoverlaySplitView
:sidebar-position] property.
Collapsing the split view automatically hides the sidebar widget, and
uncollapsing it shows the sidebar. If this behavior is not desired, the
[propertyoverlaySplitView
:pin-sidebar] property can be used to override it.
AdwOverlaySplitView
supports an edge swipe gesture for showing the sidebar,
and a swipe from the sidebar for hiding it. Gestures are only supported on
touchscreen, but not touchpad. Gestures can be controlled with the
[propertyoverlaySplitView
:enable-show-gesture] and
[propertyoverlaySplitView
:enable-hide-gesture] properties.
See also [classnavigationSplitView
].
AdwOverlaySplitView
is typically used together with an [classbreakpoint
]
setting the collapsed
property to TRUE
on small widths, as follows:
xml code
<object class="AdwWindow"> <property name="width-request">360</property> <property name="height-request">200</property> <property name="default-width">800</property> <property name="default-height">800</property> <child> <object class="AdwBreakpoint"> <condition>max-width: 400sp</condition> <setter object="split_view" property="collapsed">True</setter> </object> </child> <property name="content"> <object class="AdwOverlaySplitView" id="split_view"> <property name="sidebar"> <!-- ... --> </property> <property name="content"> <!-- ... --> </property> </object> </property> </object>
AdwOverlaySplitView
is often used for implementing the
utility pane
pattern.
Sizing
When not collapsed, AdwOverlaySplitView
changes the sidebar width
depending on its own width.
If possible, it tries to allocate a fraction of the total width, controlled
with the [propertyoverlaySplitView
:sidebar-width-fraction] property.
The sidebar also has minimum and maximum sizes, controlled with the
[propertyoverlaySplitView
:min-sidebar-width] and
[propertyoverlaySplitView
:max-sidebar-width] properties.
The minimum and maximum sizes are using the length unit specified with the
[propertyoverlaySplitView
:sidebar-width-unit].
By default, sidebar is using 25% of the total width, with 180sp as the minimum size and 280sp as the maximum size.
When collapsed, the preferred width fraction is ignored and the sidebar uses
[propertyoverlaySplitView
:max-sidebar-width] when possible.
Header Bar Integration
When used inside AdwOverlaySplitView
, [classheaderBar
] will automatically
hide the window buttons in the middle.
AdwOverlaySplitView
as GtkBuildable
The AdwOverlaySplitView
implementation of the Buildable
interface supports setting the sidebar widget by specifying “sidebar” as the
“type” attribute of a <child>
element, Specifying “content” child type or
omitting it results in setting the content widget.
CSS nodes
AdwOverlaySplitView
has a single CSS node with the name
overlay-split-view
.
It contains two nodes with the name widget
, containing the sidebar and
content children.
When not collapsed, they have the .sidebar-view
and .content-view
style
classes respectively.
overlay-split-view ├── widget.sidebar-pane │ ╰── [sidebar child] ╰── widget.content-pane ╰── [content child]
When collapsed, the one containing the sidebar child has the .background
style class and the other one has no style classes.
overlay-split-view ├── widget.background │ ╰── [sidebar child] ╰── widget ╰── [content child]
Accessibility
AdwOverlaySplitView
uses the GTK_ACCESSIBLE_ROLE_GROUP
role.
Since: 1.4
Synopsis
- newtype OverlaySplitView = OverlaySplitView (ManagedPtr OverlaySplitView)
- class (GObject o, IsDescendantOf OverlaySplitView o) => IsOverlaySplitView o
- toOverlaySplitView :: (MonadIO m, IsOverlaySplitView o) => o -> m OverlaySplitView
- overlaySplitViewGetCollapsed :: (HasCallStack, MonadIO m, IsOverlaySplitView a) => a -> m Bool
- overlaySplitViewGetContent :: (HasCallStack, MonadIO m, IsOverlaySplitView a) => a -> m (Maybe Widget)
- overlaySplitViewGetEnableHideGesture :: (HasCallStack, MonadIO m, IsOverlaySplitView a) => a -> m Bool
- overlaySplitViewGetEnableShowGesture :: (HasCallStack, MonadIO m, IsOverlaySplitView a) => a -> m Bool
- overlaySplitViewGetMaxSidebarWidth :: (HasCallStack, MonadIO m, IsOverlaySplitView a) => a -> m Double
- overlaySplitViewGetMinSidebarWidth :: (HasCallStack, MonadIO m, IsOverlaySplitView a) => a -> m Double
- overlaySplitViewGetPinSidebar :: (HasCallStack, MonadIO m, IsOverlaySplitView a) => a -> m Bool
- overlaySplitViewGetShowSidebar :: (HasCallStack, MonadIO m, IsOverlaySplitView a) => a -> m Bool
- overlaySplitViewGetSidebar :: (HasCallStack, MonadIO m, IsOverlaySplitView a) => a -> m (Maybe Widget)
- overlaySplitViewGetSidebarPosition :: (HasCallStack, MonadIO m, IsOverlaySplitView a) => a -> m PackType
- overlaySplitViewGetSidebarWidthFraction :: (HasCallStack, MonadIO m, IsOverlaySplitView a) => a -> m Double
- overlaySplitViewGetSidebarWidthUnit :: (HasCallStack, MonadIO m, IsOverlaySplitView a) => a -> m LengthUnit
- overlaySplitViewNew :: (HasCallStack, MonadIO m) => m OverlaySplitView
- overlaySplitViewSetCollapsed :: (HasCallStack, MonadIO m, IsOverlaySplitView a) => a -> Bool -> m ()
- overlaySplitViewSetContent :: (HasCallStack, MonadIO m, IsOverlaySplitView a, IsWidget b) => a -> Maybe b -> m ()
- overlaySplitViewSetEnableHideGesture :: (HasCallStack, MonadIO m, IsOverlaySplitView a) => a -> Bool -> m ()
- overlaySplitViewSetEnableShowGesture :: (HasCallStack, MonadIO m, IsOverlaySplitView a) => a -> Bool -> m ()
- overlaySplitViewSetMaxSidebarWidth :: (HasCallStack, MonadIO m, IsOverlaySplitView a) => a -> Double -> m ()
- overlaySplitViewSetMinSidebarWidth :: (HasCallStack, MonadIO m, IsOverlaySplitView a) => a -> Double -> m ()
- overlaySplitViewSetPinSidebar :: (HasCallStack, MonadIO m, IsOverlaySplitView a) => a -> Bool -> m ()
- overlaySplitViewSetShowSidebar :: (HasCallStack, MonadIO m, IsOverlaySplitView a) => a -> Bool -> m ()
- overlaySplitViewSetSidebar :: (HasCallStack, MonadIO m, IsOverlaySplitView a, IsWidget b) => a -> Maybe b -> m ()
- overlaySplitViewSetSidebarPosition :: (HasCallStack, MonadIO m, IsOverlaySplitView a) => a -> PackType -> m ()
- overlaySplitViewSetSidebarWidthFraction :: (HasCallStack, MonadIO m, IsOverlaySplitView a) => a -> Double -> m ()
- overlaySplitViewSetSidebarWidthUnit :: (HasCallStack, MonadIO m, IsOverlaySplitView a) => a -> LengthUnit -> m ()
- constructOverlaySplitViewCollapsed :: (IsOverlaySplitView o, MonadIO m) => Bool -> m (GValueConstruct o)
- getOverlaySplitViewCollapsed :: (MonadIO m, IsOverlaySplitView o) => o -> m Bool
- setOverlaySplitViewCollapsed :: (MonadIO m, IsOverlaySplitView o) => o -> Bool -> m ()
- clearOverlaySplitViewContent :: (MonadIO m, IsOverlaySplitView o) => o -> m ()
- constructOverlaySplitViewContent :: (IsOverlaySplitView o, MonadIO m, IsWidget a) => a -> m (GValueConstruct o)
- getOverlaySplitViewContent :: (MonadIO m, IsOverlaySplitView o) => o -> m (Maybe Widget)
- setOverlaySplitViewContent :: (MonadIO m, IsOverlaySplitView o, IsWidget a) => o -> a -> m ()
- constructOverlaySplitViewEnableHideGesture :: (IsOverlaySplitView o, MonadIO m) => Bool -> m (GValueConstruct o)
- getOverlaySplitViewEnableHideGesture :: (MonadIO m, IsOverlaySplitView o) => o -> m Bool
- setOverlaySplitViewEnableHideGesture :: (MonadIO m, IsOverlaySplitView o) => o -> Bool -> m ()
- constructOverlaySplitViewEnableShowGesture :: (IsOverlaySplitView o, MonadIO m) => Bool -> m (GValueConstruct o)
- getOverlaySplitViewEnableShowGesture :: (MonadIO m, IsOverlaySplitView o) => o -> m Bool
- setOverlaySplitViewEnableShowGesture :: (MonadIO m, IsOverlaySplitView o) => o -> Bool -> m ()
- constructOverlaySplitViewMaxSidebarWidth :: (IsOverlaySplitView o, MonadIO m) => Double -> m (GValueConstruct o)
- getOverlaySplitViewMaxSidebarWidth :: (MonadIO m, IsOverlaySplitView o) => o -> m Double
- setOverlaySplitViewMaxSidebarWidth :: (MonadIO m, IsOverlaySplitView o) => o -> Double -> m ()
- constructOverlaySplitViewMinSidebarWidth :: (IsOverlaySplitView o, MonadIO m) => Double -> m (GValueConstruct o)
- getOverlaySplitViewMinSidebarWidth :: (MonadIO m, IsOverlaySplitView o) => o -> m Double
- setOverlaySplitViewMinSidebarWidth :: (MonadIO m, IsOverlaySplitView o) => o -> Double -> m ()
- constructOverlaySplitViewPinSidebar :: (IsOverlaySplitView o, MonadIO m) => Bool -> m (GValueConstruct o)
- getOverlaySplitViewPinSidebar :: (MonadIO m, IsOverlaySplitView o) => o -> m Bool
- setOverlaySplitViewPinSidebar :: (MonadIO m, IsOverlaySplitView o) => o -> Bool -> m ()
- constructOverlaySplitViewShowSidebar :: (IsOverlaySplitView o, MonadIO m) => Bool -> m (GValueConstruct o)
- getOverlaySplitViewShowSidebar :: (MonadIO m, IsOverlaySplitView o) => o -> m Bool
- setOverlaySplitViewShowSidebar :: (MonadIO m, IsOverlaySplitView o) => o -> Bool -> m ()
- clearOverlaySplitViewSidebar :: (MonadIO m, IsOverlaySplitView o) => o -> m ()
- constructOverlaySplitViewSidebar :: (IsOverlaySplitView o, MonadIO m, IsWidget a) => a -> m (GValueConstruct o)
- getOverlaySplitViewSidebar :: (MonadIO m, IsOverlaySplitView o) => o -> m (Maybe Widget)
- setOverlaySplitViewSidebar :: (MonadIO m, IsOverlaySplitView o, IsWidget a) => o -> a -> m ()
- constructOverlaySplitViewSidebarPosition :: (IsOverlaySplitView o, MonadIO m) => PackType -> m (GValueConstruct o)
- getOverlaySplitViewSidebarPosition :: (MonadIO m, IsOverlaySplitView o) => o -> m PackType
- setOverlaySplitViewSidebarPosition :: (MonadIO m, IsOverlaySplitView o) => o -> PackType -> m ()
- constructOverlaySplitViewSidebarWidthFraction :: (IsOverlaySplitView o, MonadIO m) => Double -> m (GValueConstruct o)
- getOverlaySplitViewSidebarWidthFraction :: (MonadIO m, IsOverlaySplitView o) => o -> m Double
- setOverlaySplitViewSidebarWidthFraction :: (MonadIO m, IsOverlaySplitView o) => o -> Double -> m ()
- constructOverlaySplitViewSidebarWidthUnit :: (IsOverlaySplitView o, MonadIO m) => LengthUnit -> m (GValueConstruct o)
- getOverlaySplitViewSidebarWidthUnit :: (MonadIO m, IsOverlaySplitView o) => o -> m LengthUnit
- setOverlaySplitViewSidebarWidthUnit :: (MonadIO m, IsOverlaySplitView o) => o -> LengthUnit -> m ()
Exported types
newtype OverlaySplitView Source #
Memory-managed wrapper type.
Constructors
OverlaySplitView (ManagedPtr OverlaySplitView) |
Instances
class (GObject o, IsDescendantOf OverlaySplitView o) => IsOverlaySplitView o Source #
Type class for types which can be safely cast to OverlaySplitView
, for instance with toOverlaySplitView
.
Instances
(GObject o, IsDescendantOf OverlaySplitView o) => IsOverlaySplitView o Source # | |
Defined in GI.Adw.Objects.OverlaySplitView |
toOverlaySplitView :: (MonadIO m, IsOverlaySplitView o) => o -> m OverlaySplitView Source #
Cast to OverlaySplitView
, 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
Methods
actionSetEnabled, activate, activateAction, activateDefault, addController, addCssClass, addMnemonicLabel, addTickCallback, allocate, announce, bindProperty, bindPropertyFull, childFocus, computeBounds, computeExpand, computePoint, computeTransform, contains, createPangoContext, createPangoLayout, disposeTemplate, 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, updateNextAccessibleSibling, updateProperty, updateRelation, updateState, watchClosure.
Getters
getAccessibleParent, getAccessibleRole, getAllocatedBaseline, getAllocatedHeight, getAllocatedWidth, getAllocation, getAncestor, getAtContext, getBaseline, getBounds, getBuildableId, getCanFocus, getCanTarget, getCancelProgress, getChildVisible, getClipboard, getCollapsed, getColor, getContent, getCssClasses, getCssName, getCursor, getData, getDirection, getDisplay, getDistance, getEnableHideGesture, getEnableShowGesture, getFirstAccessibleChild, getFirstChild, getFocusChild, getFocusOnClick, getFocusable, getFontMap, getFontOptions, getFrameClock, getHalign, getHasTooltip, getHeight, getHexpand, getHexpandSet, getLastChild, getLayoutManager, getMapped, getMarginBottom, getMarginEnd, getMarginStart, getMarginTop, getMaxSidebarWidth, getMinSidebarWidth, getName, getNative, getNextAccessibleSibling, getNextSibling, getOpacity, getOverflow, getPangoContext, getParent, getPinSidebar, getPlatformState, getPreferredSize, getPrevSibling, getPrimaryClipboard, getProgress, getProperty, getQdata, getRealized, getReceivesDefault, getRequestMode, getRoot, getScaleFactor, getSensitive, getSettings, getShowSidebar, getSidebar, getSidebarPosition, getSidebarWidthFraction, getSidebarWidthUnit, getSize, getSizeRequest, getSnapPoints, getStateFlags, getStyleContext, getSwipeArea, getTemplateChild, getTooltipMarkup, getTooltipText, getValign, getVexpand, getVexpandSet, getVisible, getWidth.
Setters
setAccessibleParent, setCanFocus, setCanTarget, setChildVisible, setCollapsed, setContent, setCssClasses, setCursor, setCursorFromName, setData, setDataFull, setDirection, setEnableHideGesture, setEnableShowGesture, setFocusChild, setFocusOnClick, setFocusable, setFontMap, setFontOptions, setHalign, setHasTooltip, setHexpand, setHexpandSet, setLayoutManager, setMarginBottom, setMarginEnd, setMarginStart, setMarginTop, setMaxSidebarWidth, setMinSidebarWidth, setName, setOpacity, setOverflow, setParent, setPinSidebar, setProperty, setReceivesDefault, setSensitive, setShowSidebar, setSidebar, setSidebarPosition, setSidebarWidthFraction, setSidebarWidthUnit, setSizeRequest, setStateFlags, setTooltipMarkup, setTooltipText, setValign, setVexpand, setVexpandSet, setVisible.
getCollapsed
overlaySplitViewGetCollapsed Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a) | |
=> a |
|
-> m Bool | Returns: whether |
Gets whether self
is collapsed.
Since: 1.4
getContent
overlaySplitViewGetContent Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a) | |
=> a |
|
-> m (Maybe Widget) | Returns: the content widget for |
Gets the content widget for self
.
Since: 1.4
getEnableHideGesture
overlaySplitViewGetEnableHideGesture Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a) | |
=> a |
|
-> m Bool | Returns: |
Gets whether self
can be closed with a swipe gesture.
Since: 1.4
getEnableShowGesture
overlaySplitViewGetEnableShowGesture Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a) | |
=> a |
|
-> m Bool | Returns: |
Gets whether self
can be opened with an edge swipe gesture.
Since: 1.4
getMaxSidebarWidth
overlaySplitViewGetMaxSidebarWidth Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a) | |
=> a |
|
-> m Double | Returns: the maximum width |
Gets the maximum sidebar width for self
.
Since: 1.4
getMinSidebarWidth
overlaySplitViewGetMinSidebarWidth Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a) | |
=> a |
|
-> m Double | Returns: the minimum width |
Gets the minimum sidebar width for self
.
Since: 1.4
getPinSidebar
overlaySplitViewGetPinSidebar Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a) | |
=> a |
|
-> m Bool | Returns: whether if the sidebar widget is pinned |
Gets whether the sidebar widget is pinned for self
.
Since: 1.4
getShowSidebar
overlaySplitViewGetShowSidebar Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a) | |
=> a |
|
-> m Bool | Returns: |
Gets whether the sidebar widget is shown for self
.
Since: 1.4
getSidebar
overlaySplitViewGetSidebar Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a) | |
=> a |
|
-> m (Maybe Widget) | Returns: the sidebar widget for |
Gets the sidebar widget for self
.
Since: 1.4
getSidebarPosition
overlaySplitViewGetSidebarPosition Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a) | |
=> a |
|
-> m PackType | Returns: the sidebar position for |
Gets the sidebar position for self
.
Since: 1.4
getSidebarWidthFraction
overlaySplitViewGetSidebarWidthFraction Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a) | |
=> a |
|
-> m Double | Returns: the preferred width fraction |
Gets the preferred sidebar width fraction for self
.
Since: 1.4
getSidebarWidthUnit
overlaySplitViewGetSidebarWidthUnit Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a) | |
=> a |
|
-> m LengthUnit | Returns: the length unit |
Gets the length unit for minimum and maximum sidebar widths.
Since: 1.4
new
Arguments
:: (HasCallStack, MonadIO m) | |
=> m OverlaySplitView | Returns: the newly created |
Creates a new AdwOverlaySplitView
.
Since: 1.4
setCollapsed
overlaySplitViewSetCollapsed Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a) | |
=> a |
|
-> Bool |
|
-> m () |
Sets whether self
view is collapsed.
When collapsed, the sidebar widget is presented as an overlay above the content widget, otherwise they are displayed side by side.
Since: 1.4
setContent
overlaySplitViewSetContent Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a, IsWidget b) | |
=> a |
|
-> Maybe b |
|
-> m () |
Sets the content widget for self
.
Since: 1.4
setEnableHideGesture
overlaySplitViewSetEnableHideGesture Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a) | |
=> a |
|
-> Bool |
|
-> m () |
Sets whether self
can be closed with a swipe gesture.
Only touchscreen swipes are supported.
Since: 1.4
setEnableShowGesture
overlaySplitViewSetEnableShowGesture Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a) | |
=> a |
|
-> Bool |
|
-> m () |
Sets whether self
can be opened with an edge swipe gesture.
Only touchscreen swipes are supported.
Since: 1.4
setMaxSidebarWidth
overlaySplitViewSetMaxSidebarWidth Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a) | |
=> a |
|
-> Double |
|
-> m () |
Sets the maximum sidebar width for self
.
Maximum width is affected by [propertyoverlaySplitView
:sidebar-width-unit].
The sidebar widget can still be allocated with larger width if its own minimum width exceeds it.
Since: 1.4
setMinSidebarWidth
overlaySplitViewSetMinSidebarWidth Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a) | |
=> a |
|
-> Double |
|
-> m () |
Sets the minimum sidebar width for self
.
Minimum width is affected by [propertyoverlaySplitView
:sidebar-width-unit].
The sidebar widget can still be allocated with larger width if its own minimum width exceeds it.
Since: 1.4
setPinSidebar
overlaySplitViewSetPinSidebar Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a) | |
=> a |
|
-> Bool |
|
-> m () |
Sets whether the sidebar widget is pinned for self
.
By default, collapsing self
automatically hides the sidebar widget, and
uncollapsing it shows the sidebar. If set to TRUE
, sidebar visibility never
changes on its own.
Since: 1.4
setShowSidebar
overlaySplitViewSetShowSidebar Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a) | |
=> a |
|
-> Bool |
|
-> m () |
Sets whether the sidebar widget is shown for self
.
Since: 1.4
setSidebar
overlaySplitViewSetSidebar Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a, IsWidget b) | |
=> a |
|
-> Maybe b |
|
-> m () |
Sets the sidebar widget for self
.
Since: 1.4
setSidebarPosition
overlaySplitViewSetSidebarPosition Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a) | |
=> a |
|
-> PackType |
|
-> m () |
Sets the sidebar position for self
.
If it's set to GTK_PACK_START
, the sidebar is displayed before the content,
if GTK_PACK_END
, it's displayed after the content.
Since: 1.4
setSidebarWidthFraction
overlaySplitViewSetSidebarWidthFraction Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a) | |
=> a |
|
-> Double |
|
-> m () |
Sets the preferred sidebar width as a fraction of the total width of self
.
The preferred width is additionally limited by
[propertyoverlaySplitView
:min-sidebar-width] and
[propertyoverlaySplitView
:max-sidebar-width].
The sidebar widget can be allocated with larger width if its own minimum width exceeds the preferred width.
Since: 1.4
setSidebarWidthUnit
overlaySplitViewSetSidebarWidthUnit Source #
Arguments
:: (HasCallStack, MonadIO m, IsOverlaySplitView a) | |
=> a |
|
-> LengthUnit |
|
-> m () |
Sets the length unit for minimum and maximum sidebar widths.
See [propertyoverlaySplitView
:min-sidebar-width] and
[propertyoverlaySplitView
:max-sidebar-width].
Since: 1.4
Properties
collapsed
Whether the split view is collapsed.
When collapsed, the sidebar widget is presented as an overlay above the content widget, otherwise they are displayed side by side.
Since: 1.4
constructOverlaySplitViewCollapsed :: (IsOverlaySplitView o, MonadIO m) => Bool -> m (GValueConstruct o) Source #
Construct a GValueConstruct
with valid value for the “collapsed
” property. This is rarely needed directly, but it is used by new
.
getOverlaySplitViewCollapsed :: (MonadIO m, IsOverlaySplitView o) => o -> m Bool Source #
Get the value of the “collapsed
” property.
When overloading is enabled, this is equivalent to
get
overlaySplitView #collapsed
setOverlaySplitViewCollapsed :: (MonadIO m, IsOverlaySplitView o) => o -> Bool -> m () Source #
Set the value of the “collapsed
” property.
When overloading is enabled, this is equivalent to
set
overlaySplitView [ #collapsed:=
value ]
content
The content widget.
Since: 1.4
clearOverlaySplitViewContent :: (MonadIO m, IsOverlaySplitView o) => o -> m () Source #
Set the value of the “content
” property to Nothing
.
When overloading is enabled, this is equivalent to
clear
#content
constructOverlaySplitViewContent :: (IsOverlaySplitView o, MonadIO m, IsWidget a) => a -> m (GValueConstruct o) Source #
Construct a GValueConstruct
with valid value for the “content
” property. This is rarely needed directly, but it is used by new
.
getOverlaySplitViewContent :: (MonadIO m, IsOverlaySplitView o) => o -> m (Maybe Widget) Source #
Get the value of the “content
” property.
When overloading is enabled, this is equivalent to
get
overlaySplitView #content
setOverlaySplitViewContent :: (MonadIO m, IsOverlaySplitView o, IsWidget a) => o -> a -> m () Source #
Set the value of the “content
” property.
When overloading is enabled, this is equivalent to
set
overlaySplitView [ #content:=
value ]
enableHideGesture
Whether the sidebar can be closed with a swipe gesture.
Only touchscreen swipes are supported.
Since: 1.4
constructOverlaySplitViewEnableHideGesture :: (IsOverlaySplitView o, MonadIO m) => Bool -> m (GValueConstruct o) Source #
Construct a GValueConstruct
with valid value for the “enable-hide-gesture
” property. This is rarely needed directly, but it is used by new
.
getOverlaySplitViewEnableHideGesture :: (MonadIO m, IsOverlaySplitView o) => o -> m Bool Source #
Get the value of the “enable-hide-gesture
” property.
When overloading is enabled, this is equivalent to
get
overlaySplitView #enableHideGesture
setOverlaySplitViewEnableHideGesture :: (MonadIO m, IsOverlaySplitView o) => o -> Bool -> m () Source #
Set the value of the “enable-hide-gesture
” property.
When overloading is enabled, this is equivalent to
set
overlaySplitView [ #enableHideGesture:=
value ]
enableShowGesture
Whether the sidebar can be opened with an edge swipe gesture.
Only touchscreen swipes are supported.
Since: 1.4
constructOverlaySplitViewEnableShowGesture :: (IsOverlaySplitView o, MonadIO m) => Bool -> m (GValueConstruct o) Source #
Construct a GValueConstruct
with valid value for the “enable-show-gesture
” property. This is rarely needed directly, but it is used by new
.
getOverlaySplitViewEnableShowGesture :: (MonadIO m, IsOverlaySplitView o) => o -> m Bool Source #
Get the value of the “enable-show-gesture
” property.
When overloading is enabled, this is equivalent to
get
overlaySplitView #enableShowGesture
setOverlaySplitViewEnableShowGesture :: (MonadIO m, IsOverlaySplitView o) => o -> Bool -> m () Source #
Set the value of the “enable-show-gesture
” property.
When overloading is enabled, this is equivalent to
set
overlaySplitView [ #enableShowGesture:=
value ]
maxSidebarWidth
The maximum sidebar width.
Maximum width is affected by
[propertyoverlaySplitView
:sidebar-width-unit].
The sidebar widget can still be allocated with larger width if its own minimum width exceeds it.
Since: 1.4
constructOverlaySplitViewMaxSidebarWidth :: (IsOverlaySplitView o, MonadIO m) => Double -> m (GValueConstruct o) Source #
Construct a GValueConstruct
with valid value for the “max-sidebar-width
” property. This is rarely needed directly, but it is used by new
.
getOverlaySplitViewMaxSidebarWidth :: (MonadIO m, IsOverlaySplitView o) => o -> m Double Source #
Get the value of the “max-sidebar-width
” property.
When overloading is enabled, this is equivalent to
get
overlaySplitView #maxSidebarWidth
setOverlaySplitViewMaxSidebarWidth :: (MonadIO m, IsOverlaySplitView o) => o -> Double -> m () Source #
Set the value of the “max-sidebar-width
” property.
When overloading is enabled, this is equivalent to
set
overlaySplitView [ #maxSidebarWidth:=
value ]
minSidebarWidth
The minimum sidebar width.
Minimum width is affected by
[propertyoverlaySplitView
:sidebar-width-unit].
The sidebar widget can still be allocated with larger width if its own minimum width exceeds it.
Since: 1.4
constructOverlaySplitViewMinSidebarWidth :: (IsOverlaySplitView o, MonadIO m) => Double -> m (GValueConstruct o) Source #
Construct a GValueConstruct
with valid value for the “min-sidebar-width
” property. This is rarely needed directly, but it is used by new
.
getOverlaySplitViewMinSidebarWidth :: (MonadIO m, IsOverlaySplitView o) => o -> m Double Source #
Get the value of the “min-sidebar-width
” property.
When overloading is enabled, this is equivalent to
get
overlaySplitView #minSidebarWidth
setOverlaySplitViewMinSidebarWidth :: (MonadIO m, IsOverlaySplitView o) => o -> Double -> m () Source #
Set the value of the “min-sidebar-width
” property.
When overloading is enabled, this is equivalent to
set
overlaySplitView [ #minSidebarWidth:=
value ]
pinSidebar
Whether the sidebar widget is pinned.
By default, collapsing self
automatically hides the sidebar widget, and
uncollapsing it shows the sidebar. If set to TRUE
, sidebar visibility
never changes on its own.
Since: 1.4
constructOverlaySplitViewPinSidebar :: (IsOverlaySplitView o, MonadIO m) => Bool -> m (GValueConstruct o) Source #
Construct a GValueConstruct
with valid value for the “pin-sidebar
” property. This is rarely needed directly, but it is used by new
.
getOverlaySplitViewPinSidebar :: (MonadIO m, IsOverlaySplitView o) => o -> m Bool Source #
Get the value of the “pin-sidebar
” property.
When overloading is enabled, this is equivalent to
get
overlaySplitView #pinSidebar
setOverlaySplitViewPinSidebar :: (MonadIO m, IsOverlaySplitView o) => o -> Bool -> m () Source #
Set the value of the “pin-sidebar
” property.
When overloading is enabled, this is equivalent to
set
overlaySplitView [ #pinSidebar:=
value ]
showSidebar
Whether the sidebar widget is shown.
Since: 1.4
constructOverlaySplitViewShowSidebar :: (IsOverlaySplitView o, MonadIO m) => Bool -> m (GValueConstruct o) Source #
Construct a GValueConstruct
with valid value for the “show-sidebar
” property. This is rarely needed directly, but it is used by new
.
getOverlaySplitViewShowSidebar :: (MonadIO m, IsOverlaySplitView o) => o -> m Bool Source #
Get the value of the “show-sidebar
” property.
When overloading is enabled, this is equivalent to
get
overlaySplitView #showSidebar
setOverlaySplitViewShowSidebar :: (MonadIO m, IsOverlaySplitView o) => o -> Bool -> m () Source #
Set the value of the “show-sidebar
” property.
When overloading is enabled, this is equivalent to
set
overlaySplitView [ #showSidebar:=
value ]
sidebar
The sidebar widget.
Since: 1.4
clearOverlaySplitViewSidebar :: (MonadIO m, IsOverlaySplitView o) => o -> m () Source #
Set the value of the “sidebar
” property to Nothing
.
When overloading is enabled, this is equivalent to
clear
#sidebar
constructOverlaySplitViewSidebar :: (IsOverlaySplitView o, MonadIO m, IsWidget a) => a -> m (GValueConstruct o) Source #
Construct a GValueConstruct
with valid value for the “sidebar
” property. This is rarely needed directly, but it is used by new
.
getOverlaySplitViewSidebar :: (MonadIO m, IsOverlaySplitView o) => o -> m (Maybe Widget) Source #
Get the value of the “sidebar
” property.
When overloading is enabled, this is equivalent to
get
overlaySplitView #sidebar
setOverlaySplitViewSidebar :: (MonadIO m, IsOverlaySplitView o, IsWidget a) => o -> a -> m () Source #
Set the value of the “sidebar
” property.
When overloading is enabled, this is equivalent to
set
overlaySplitView [ #sidebar:=
value ]
sidebarPosition
The sidebar position.
If it's set to GTK_PACK_START
, the sidebar is displayed before the content,
if GTK_PACK_END
, it's displayed after the content.
Since: 1.4
constructOverlaySplitViewSidebarPosition :: (IsOverlaySplitView o, MonadIO m) => PackType -> m (GValueConstruct o) Source #
Construct a GValueConstruct
with valid value for the “sidebar-position
” property. This is rarely needed directly, but it is used by new
.
getOverlaySplitViewSidebarPosition :: (MonadIO m, IsOverlaySplitView o) => o -> m PackType Source #
Get the value of the “sidebar-position
” property.
When overloading is enabled, this is equivalent to
get
overlaySplitView #sidebarPosition
setOverlaySplitViewSidebarPosition :: (MonadIO m, IsOverlaySplitView o) => o -> PackType -> m () Source #
Set the value of the “sidebar-position
” property.
When overloading is enabled, this is equivalent to
set
overlaySplitView [ #sidebarPosition:=
value ]
sidebarWidthFraction
The preferred sidebar width as a fraction of the total width.
The preferred width is additionally limited by
[propertyoverlaySplitView
:min-sidebar-width] and
[propertyoverlaySplitView
:max-sidebar-width].
The sidebar widget can be allocated with larger width if its own minimum width exceeds the preferred width.
Since: 1.4
constructOverlaySplitViewSidebarWidthFraction :: (IsOverlaySplitView o, MonadIO m) => Double -> m (GValueConstruct o) Source #
Construct a GValueConstruct
with valid value for the “sidebar-width-fraction
” property. This is rarely needed directly, but it is used by new
.
getOverlaySplitViewSidebarWidthFraction :: (MonadIO m, IsOverlaySplitView o) => o -> m Double Source #
Get the value of the “sidebar-width-fraction
” property.
When overloading is enabled, this is equivalent to
get
overlaySplitView #sidebarWidthFraction
setOverlaySplitViewSidebarWidthFraction :: (MonadIO m, IsOverlaySplitView o) => o -> Double -> m () Source #
Set the value of the “sidebar-width-fraction
” property.
When overloading is enabled, this is equivalent to
set
overlaySplitView [ #sidebarWidthFraction:=
value ]
sidebarWidthUnit
The length unit for minimum and maximum sidebar widths.
See [propertyoverlaySplitView
:min-sidebar-width] and
[propertyoverlaySplitView
:max-sidebar-width].
Since: 1.4
constructOverlaySplitViewSidebarWidthUnit :: (IsOverlaySplitView o, MonadIO m) => LengthUnit -> m (GValueConstruct o) Source #
Construct a GValueConstruct
with valid value for the “sidebar-width-unit
” property. This is rarely needed directly, but it is used by new
.
getOverlaySplitViewSidebarWidthUnit :: (MonadIO m, IsOverlaySplitView o) => o -> m LengthUnit Source #
Get the value of the “sidebar-width-unit
” property.
When overloading is enabled, this is equivalent to
get
overlaySplitView #sidebarWidthUnit
setOverlaySplitViewSidebarWidthUnit :: (MonadIO m, IsOverlaySplitView o) => o -> LengthUnit -> m () Source #
Set the value of the “sidebar-width-unit
” property.
When overloading is enabled, this is equivalent to
set
overlaySplitView [ #sidebarWidthUnit:=
value ]