| 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
setoverlaySplitView [ #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
setoverlaySplitView [ #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
setoverlaySplitView [ #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
setoverlaySplitView [ #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
setoverlaySplitView [ #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
setoverlaySplitView [ #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
setoverlaySplitView [ #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
setoverlaySplitView [ #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
setoverlaySplitView [ #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
setoverlaySplitView [ #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
setoverlaySplitView [ #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
setoverlaySplitView [ #sidebarWidthUnit:=value ]