Graphics.UI.Gtk.MenuComboToolbar.ToolPalette

gtk3-0.14.5: Binding to the Gtk+ 3 graphical user interface library

Maintainer | gtk2hs-users@lists.sourceforge.net
Stability | provisional
Portability | portable (depends on GHC)
Safe Haskell | None
Language | Haskell98

Graphics.UI.Gtk.MenuComboToolbar.ToolPalette

Contents

- Detail
- Class Hierarchy
- Types
- Enums
- Constructors
- Methods
- Attributes
- Child Attributes
- Signals

Description

A tool palette with categories

- Module available since Gtk+ version 2.20

TODO:

gtk_tool_palette_add_drag_dest gtk_tool_palette_get_drag_item gtk_tool_palette_get_drag_target_group gtk_tool_palette_get_drag_target_item gtk_tool_palette_get_drop_group gtk_tool_palette_get_drop_item

Synopsis

- data ToolPalette
- class ContainerClass o => ToolPaletteClass o
- castToToolPalette :: GObjectClass obj => obj -> ToolPalette
- toToolPalette :: ToolPaletteClass o => o -> ToolPalette
- data ToolPaletteDragTargets
  - = ToolPaletteDragItems
  - | ToolPaletteDragGroups
- toolPaletteNew :: IO ToolPalette
- toolPaletteUnsetIconSize :: ToolPaletteClass self => self -> IO ()
- toolPaletteUnsetStyle :: ToolPaletteClass self => self -> IO ()
- toolPaletteGetHAdjustment :: ToolPaletteClass self => self -> IO Adjustment
- toolPaletteGetVAdjustment :: ToolPaletteClass self => self -> IO Adjustment
- toolPaletteSetGroupPosition :: (ToolPaletteClass palette, ToolItemGroupClass group) => palette -> group -> Int -> IO ()
- toolPaletteGetGroupPosition :: (ToolPaletteClass palette, ToolItemGroupClass group) => palette -> group -> IO Int
- toolPaletteIconSize :: ToolPaletteClass self => Attr self IconSize
- toolPaletteIconSizeSet :: ToolPaletteClass self => Attr self Bool
- toolPaletteToolbarStyle :: ToolPaletteClass self => Attr self ToolbarStyle
- toolPaletteChildExclusive :: ToolPaletteClass self => Attr self Bool
- toolPaletteChildExpand :: ToolPaletteClass self => Attr self Bool
- toolPaletteSetScrollAdjustments :: ToolPaletteClass self => Signal self (Adjustment -> Adjustment -> IO ())

# Detail

A `ToolPalette` allows you to add `ToolItems` to a palette-like container with different categories and drag and drop support.

A `ToolPalette` is created with a call to `toolPaletteNew`.

`ToolItems` cannot be added directly to a `ToolPalette` - instead they are added to a `ToolItemGroup` which can than be added to a `ToolPalette`. To add a `ToolItemGroup` to a `ToolPalette`, use `containerAdd`.

The easiest way to use drag and drop with `ToolPalette` is to call `toolPaletteAddDragDest` with the desired drag source palette and the desired drag target widget. Then `toolPaletteGetDragItem` can be used to get the dragged item in the `dragDataReceived` signal handler of the drag target.

# Class Hierarchy

    | GObject
    | +----Object
    | +----Widget
    | +----Container
    | +----ToolPalette

# Types

data ToolPalette #

Instances

Eq ToolPalette # |
Methods (==) :: ToolPalette -> ToolPalette -> Bool # (/=) :: ToolPalette -> ToolPalette -> Bool #
Ord ToolPalette # |
Methods compare :: ToolPalette -> ToolPalette -> Ordering # (<) :: ToolPalette -> ToolPalette -> Bool # (<=) :: ToolPalette -> ToolPalette -> Bool # (>) :: ToolPalette -> ToolPalette -> Bool # (>=) :: ToolPalette -> ToolPalette -> Bool # max :: ToolPalette -> ToolPalette -> ToolPalette # min :: ToolPalette -> ToolPalette -> ToolPalette #
GObjectClass ToolPalette # |
Methods toGObject :: ToolPalette -> GObject # unsafeCastGObject :: GObject -> ToolPalette #
ToolPaletteClass ToolPalette # |
ContainerClass ToolPalette # |
WidgetClass ToolPalette # |

class ContainerClass o => ToolPaletteClass o #

Instances

ToolPaletteClass ToolPalette # |

castToToolPalette :: GObjectClass obj => obj -> ToolPalette #

toToolPalette :: ToolPaletteClass o => o -> ToolPalette #

# Enums

data ToolPaletteDragTargets #

Flags used to specify the supported drag targets.

Constructors

ToolPaletteDragItems |
ToolPaletteDragGroups |

Instances

Enum ToolPaletteDragTargets # | Creates a new tool palette. Available since Gtk+ version 2.20
Methods succ :: ToolPaletteDragTargets -> ToolPaletteDragTargets # pred :: ToolPaletteDragTargets -> ToolPaletteDragTargets # toEnum :: Int -> ToolPaletteDragTargets # fromEnum :: ToolPaletteDragTargets -> Int # enumFrom :: ToolPaletteDragTargets -> [ToolPaletteDragTargets] # enumFromThen :: ToolPaletteDragTargets -> ToolPaletteDragTargets -> [ToolPaletteDragTargets] # enumFromTo :: ToolPaletteDragTargets -> ToolPaletteDragTargets -> [ToolPaletteDragTargets] # enumFromThenTo :: ToolPaletteDragTargets -> ToolPaletteDragTargets -> ToolPaletteDragTargets -> [ToolPaletteDragTargets] #
Eq ToolPaletteDragTargets # |
Methods (==) :: ToolPaletteDragTargets -> ToolPaletteDragTargets -> Bool # (/=) :: ToolPaletteDragTargets -> ToolPaletteDragTargets -> Bool #

# Constructors

toolPaletteNew :: IO ToolPalette #

# Methods

toolPaletteUnsetIconSize :: ToolPaletteClass self => self -> IO () #

Unsets the tool palette icon size set with `toolPaletteSetIconSize`, so that user preferences will be used to determine the icon size.

- Available since Gtk+ version 2.20

toolPaletteUnsetStyle :: ToolPaletteClass self => self -> IO () #

Unsets a toolbar style set with `toolPaletteSetStyle`, so that user preferences will be used to determine the toolbar style.

- Available since Gtk+ version 2.20

toolPaletteGetHAdjustment :: ToolPaletteClass self => self -> IO Adjustment #

Gets the horizontal adjustment of the tool palette.

- Available since Gtk+ version 2.20

toolPaletteGetVAdjustment :: ToolPaletteClass self => self -> IO Adjustment #

Gets the vertical adjustment of the tool palette.

- Available since Gtk+ version 2.20

# Attributes

toolPaletteSetGroupPosition :: (ToolPaletteClass palette, ToolItemGroupClass group) => palette -> group -> Int -> IO () #

Sets the position of the group as an index of the tool palette. If position is 0 the group will become the first child, if position is -1 it will become the last child.

- Available since Gtk+ version 2.20

toolPaletteGetGroupPosition #

Arguments

:: (ToolPaletteClass palette, ToolItemGroupClass group) |
=> palette |
-> group |
-> IO Int | returns the index of group or -1 if group is not a child of palette

Gets the position of group in palette as index. See `toolPaletteSetGroupPosition`.

- Available since Gtk+ version 2.20

toolPaletteIconSize :: ToolPaletteClass self => Attr self IconSize #

The size of the icons in a tool palette is normally determined by the `toolbarIconSize` setting. When this property is set, it overrides the setting.

This should only be used for special-purpose tool palettes, normal application tool palettes should respect the user preferences for the size of icons.

Default value: `IconSizeSmallToolbar`

- Available since Gtk+ version 2.20

toolPaletteIconSizeSet :: ToolPaletteClass self => Attr self Bool #

Is `True` if the `iconSize` property has been set.

Default value: `False`

- Available since Gtk+ version 2.20

toolPaletteToolbarStyle :: ToolPaletteClass self => Attr self ToolbarStyle #

The style of items in the tool palette.

Default value: `ToolbarIcons`

- Available since Gtk+ version 2.20

# Child Attributes

toolPaletteChildExclusive :: ToolPaletteClass self => Attr self Bool #

Whether the item group should be the only one that is expanded at a given time.

Default value: `False`

- Available since Gtk+ version 2.20

toolPaletteChildExpand :: ToolPaletteClass self => Attr self Bool #

Whether the item group should receive extra space when the palette grows. at a given time.

Default value: `False`

- Available since Gtk+ version 2.20

# Signals

toolPaletteSetScrollAdjustments :: ToolPaletteClass self => Signal self (Adjustment -> Adjustment -> IO ()) #

Set the scroll adjustments for the viewport. Usually scrolled containers like `ScrolledWindow` will emit this signal to connect two instances of `Scrollbar` to the scroll directions of the `Toolpalette`.

- Available since Gtk+ version 2.20