| Copyright | Will Thompson Iñaki García Etxebarria and Jonas Platte |
|---|---|
| License | LGPL-2.1 |
| Maintainer | Iñaki García Etxebarria (garetxe@gmail.com) |
| Safe Haskell | None |
| Language | Haskell2010 |
GI.Gtk.Interfaces.Scrollable
Contents
Description
Scrollable is an interface that is implemented by widgets with native
scrolling ability.
To implement this interface you should override the
Scrollable:hadjustment and Scrollable:vadjustment properties.
Creating a scrollable widget
All scrollable widgets should do the following.
- When a parent widget sets the scrollable child widget’s adjustments,
the widget should populate the adjustments’
Adjustment:lower,Adjustment:upper,Adjustment:step-increment,Adjustment:page-incrementandAdjustment:page-sizeproperties and connect to theAdjustment::value-changedsignal. - Because its preferred size is the size for a fully expanded widget,
the scrollable widget must be able to cope with underallocations.
This means that it must accept any value passed to its
WidgetClass.size_allocate() function. - When the parent allocates space to the scrollable child widget, the widget should update the adjustments’ properties with new values.
- When any of the adjustments emits the
Adjustment::value-changedsignal, the scrollable widget should scroll its contents.
- newtype Scrollable = Scrollable (ManagedPtr Scrollable)
- noScrollable :: Maybe Scrollable
- class GObject o => IsScrollable o
- toScrollable :: (MonadIO m, IsScrollable o) => o -> m Scrollable
- scrollableGetBorder :: (HasCallStack, MonadIO m, IsScrollable a) => a -> m (Bool, Border)
- scrollableGetHadjustment :: (HasCallStack, MonadIO m, IsScrollable a) => a -> m Adjustment
- scrollableGetHscrollPolicy :: (HasCallStack, MonadIO m, IsScrollable a) => a -> m ScrollablePolicy
- scrollableGetVadjustment :: (HasCallStack, MonadIO m, IsScrollable a) => a -> m Adjustment
- scrollableGetVscrollPolicy :: (HasCallStack, MonadIO m, IsScrollable a) => a -> m ScrollablePolicy
- scrollableSetHadjustment :: (HasCallStack, MonadIO m, IsScrollable a, IsAdjustment b) => a -> Maybe b -> m ()
- scrollableSetHscrollPolicy :: (HasCallStack, MonadIO m, IsScrollable a) => a -> ScrollablePolicy -> m ()
- scrollableSetVadjustment :: (HasCallStack, MonadIO m, IsScrollable a, IsAdjustment b) => a -> Maybe b -> m ()
- scrollableSetVscrollPolicy :: (HasCallStack, MonadIO m, IsScrollable a) => a -> ScrollablePolicy -> m ()
- clearScrollableHadjustment :: (MonadIO m, IsScrollable o) => o -> m ()
- constructScrollableHadjustment :: (IsScrollable o, IsAdjustment a) => a -> IO (GValueConstruct o)
- getScrollableHadjustment :: (MonadIO m, IsScrollable o) => o -> m Adjustment
- setScrollableHadjustment :: (MonadIO m, IsScrollable o, IsAdjustment a) => o -> a -> m ()
- constructScrollableHscrollPolicy :: IsScrollable o => ScrollablePolicy -> IO (GValueConstruct o)
- getScrollableHscrollPolicy :: (MonadIO m, IsScrollable o) => o -> m ScrollablePolicy
- setScrollableHscrollPolicy :: (MonadIO m, IsScrollable o) => o -> ScrollablePolicy -> m ()
- clearScrollableVadjustment :: (MonadIO m, IsScrollable o) => o -> m ()
- constructScrollableVadjustment :: (IsScrollable o, IsAdjustment a) => a -> IO (GValueConstruct o)
- getScrollableVadjustment :: (MonadIO m, IsScrollable o) => o -> m Adjustment
- setScrollableVadjustment :: (MonadIO m, IsScrollable o, IsAdjustment a) => o -> a -> m ()
- constructScrollableVscrollPolicy :: IsScrollable o => ScrollablePolicy -> IO (GValueConstruct o)
- getScrollableVscrollPolicy :: (MonadIO m, IsScrollable o) => o -> m ScrollablePolicy
- setScrollableVscrollPolicy :: (MonadIO m, IsScrollable o) => o -> ScrollablePolicy -> m ()
Exported types
class GObject o => IsScrollable o Source #
Instances
toScrollable :: (MonadIO m, IsScrollable o) => o -> m Scrollable Source #
Methods
getBorder
Arguments
| :: (HasCallStack, MonadIO m, IsScrollable a) | |
| => a |
|
| -> m (Bool, Border) | Returns: |
Returns the size of a non-scrolling border around the outside of the scrollable. An example for this would be treeview headers. GTK+ can use this information to display overlayed graphics, like the overshoot indication, at the right position.
Since: 3.16
getHadjustment
scrollableGetHadjustment Source #
Arguments
| :: (HasCallStack, MonadIO m, IsScrollable a) | |
| => a |
|
| -> m Adjustment | Returns: horizontal |
Retrieves the Adjustment used for horizontal scrolling.
Since: 3.0
getHscrollPolicy
scrollableGetHscrollPolicy Source #
Arguments
| :: (HasCallStack, MonadIO m, IsScrollable a) | |
| => a |
|
| -> m ScrollablePolicy | Returns: The horizontal |
Gets the horizontal ScrollablePolicy.
Since: 3.0
getVadjustment
scrollableGetVadjustment Source #
Arguments
| :: (HasCallStack, MonadIO m, IsScrollable a) | |
| => a |
|
| -> m Adjustment | Returns: vertical |
Retrieves the Adjustment used for vertical scrolling.
Since: 3.0
getVscrollPolicy
scrollableGetVscrollPolicy Source #
Arguments
| :: (HasCallStack, MonadIO m, IsScrollable a) | |
| => a |
|
| -> m ScrollablePolicy | Returns: The vertical |
Gets the vertical ScrollablePolicy.
Since: 3.0
setHadjustment
scrollableSetHadjustment Source #
Arguments
| :: (HasCallStack, MonadIO m, IsScrollable a, IsAdjustment b) | |
| => a |
|
| -> Maybe b |
|
| -> m () |
Sets the horizontal adjustment of the Scrollable.
Since: 3.0
setHscrollPolicy
scrollableSetHscrollPolicy Source #
Arguments
| :: (HasCallStack, MonadIO m, IsScrollable a) | |
| => a |
|
| -> ScrollablePolicy |
|
| -> m () |
Sets the ScrollablePolicy to determine whether
horizontal scrolling should start below the minimum width or
below the natural width.
Since: 3.0
setVadjustment
scrollableSetVadjustment Source #
Arguments
| :: (HasCallStack, MonadIO m, IsScrollable a, IsAdjustment b) | |
| => a |
|
| -> Maybe b |
|
| -> m () |
Sets the vertical adjustment of the Scrollable.
Since: 3.0
setVscrollPolicy
scrollableSetVscrollPolicy Source #
Arguments
| :: (HasCallStack, MonadIO m, IsScrollable a) | |
| => a |
|
| -> ScrollablePolicy |
|
| -> m () |
Sets the ScrollablePolicy to determine whether
vertical scrolling should start below the minimum height or
below the natural height.
Since: 3.0
Properties
hadjustment
clearScrollableHadjustment :: (MonadIO m, IsScrollable o) => o -> m () Source #
constructScrollableHadjustment :: (IsScrollable o, IsAdjustment a) => a -> IO (GValueConstruct o) Source #
getScrollableHadjustment :: (MonadIO m, IsScrollable o) => o -> m Adjustment Source #
setScrollableHadjustment :: (MonadIO m, IsScrollable o, IsAdjustment a) => o -> a -> m () Source #
hscrollPolicy
constructScrollableHscrollPolicy :: IsScrollable o => ScrollablePolicy -> IO (GValueConstruct o) Source #
getScrollableHscrollPolicy :: (MonadIO m, IsScrollable o) => o -> m ScrollablePolicy Source #
setScrollableHscrollPolicy :: (MonadIO m, IsScrollable o) => o -> ScrollablePolicy -> m () Source #
vadjustment
clearScrollableVadjustment :: (MonadIO m, IsScrollable o) => o -> m () Source #
constructScrollableVadjustment :: (IsScrollable o, IsAdjustment a) => a -> IO (GValueConstruct o) Source #
getScrollableVadjustment :: (MonadIO m, IsScrollable o) => o -> m Adjustment Source #
setScrollableVadjustment :: (MonadIO m, IsScrollable o, IsAdjustment a) => o -> a -> m () Source #
vscrollPolicy
constructScrollableVscrollPolicy :: IsScrollable o => ScrollablePolicy -> IO (GValueConstruct o) Source #
getScrollableVscrollPolicy :: (MonadIO m, IsScrollable o) => o -> m ScrollablePolicy Source #
setScrollableVscrollPolicy :: (MonadIO m, IsScrollable o) => o -> ScrollablePolicy -> m () Source #