Portability | portable (depends on GHC) |
---|---|
Stability | provisional |
Maintainer | gtk2hs-users@lists.sourceforge.net |
Safe Haskell | None |
A button which pops up a scale
- Module available since Gtk+ version 2.12
- data ScaleButton
- class ButtonClass o => ScaleButtonClass o
- castToScaleButton :: GObjectClass obj => obj -> ScaleButton
- toScaleButton :: ScaleButtonClass o => o -> ScaleButton
- scaleButtonNew :: IconSize -> Double -> Double -> Double -> [String] -> IO ScaleButton
- scaleButtonSetIcons :: ScaleButtonClass self => self -> [String] -> IO ()
- scaleButtonGetPopup :: ScaleButtonClass self => self -> IO Widget
- scaleButtonGetPlusButton :: ScaleButtonClass self => self -> IO Widget
- scaleButtonGetMinusButton :: ScaleButtonClass self => self -> IO Widget
- scaleButtonValue :: ScaleButtonClass self => Attr self Double
- scaleButtonSize :: ScaleButtonClass self => Attr self IconSize
- scaleButtonAdjustment :: ScaleButtonClass self => Attr self Adjustment
- scaleButtonIcons :: ScaleButtonClass self => ReadWriteAttr self [String] (Maybe [String])
- scaleButtonPopdown :: ScaleButtonClass self => Signal self (IO ())
- scaleButtonPopup :: ScaleButtonClass self => Signal self (IO ())
- scaleButtonValueChanged :: ScaleButtonClass self => Signal self (Double -> IO ())
Detail
ScaleButton
provides a button which pops up a scale widget. This kind
of widget is commonly used for volume controls in multimedia applications,
and Gtk+ provides a VolumeButton
subclass that is tailored for this use
case.
Class Hierarchy
|GObject
| +----Object
| +----Widget
| +----Container
| +----Bin
| +----Button
| +----ScaleButton | +----VolumeButton
Types
data ScaleButton Source
class ButtonClass o => ScaleButtonClass o Source
castToScaleButton :: GObjectClass obj => obj -> ScaleButtonSource
toScaleButton :: ScaleButtonClass o => o -> ScaleButtonSource
Constructors
:: IconSize |
|
-> Double |
|
-> Double |
|
-> Double |
|
-> [String] | icons |
-> IO ScaleButton |
Creates a ScaleButton
, with a range between min
and max
, with a
stepping of step
.
Methods
:: ScaleButtonClass self | |
=> self | |
-> [String] | icons |
-> IO () |
Sets the icons to be used by the scale button. For details, see the icons property.
:: ScaleButtonClass self | |
=> self | |
-> IO Widget | returns the popup of the |
Retrieves the popup of the ScaleButton
.
- Available since Gtk+ version 2.14
scaleButtonGetPlusButtonSource
:: ScaleButtonClass self | |
=> self | |
-> IO Widget | returns the plus button of the |
Retrieves the plus button of the ScaleButton
.
- Available since Gtk+ version 2.14
scaleButtonGetMinusButtonSource
:: ScaleButtonClass self | |
=> self | |
-> IO Widget | returns the minus button of the |
Retrieves the minus button of the ScaleButton
.
- Available since Gtk+ version 2.14
Attributes
scaleButtonValue :: ScaleButtonClass self => Attr self DoubleSource
The value of the scale.
Default value: 0
scaleButtonSize :: ScaleButtonClass self => Attr self IconSizeSource
The icon size.
Default value: ''IconSizeSmallToolbar''
scaleButtonAdjustment :: ScaleButtonClass self => Attr self AdjustmentSource
The Adjustment
that contains the current value of this scale button object.
scaleButtonIcons :: ScaleButtonClass self => ReadWriteAttr self [String] (Maybe [String])Source
The names of the icons to be used by the scale button. The first item in the array will be used in the button when the current value is the lowest value, the second item for the highest value. All the subsequent icons will be used for all the other values, spread evenly over the range of values.
If there's only one icon name in the icons array, it will be used for all the values. If only two icon names are in the icons array, the first one will be used for the bottom 50% of the scale, and the second one for the top 50%.
It is recommended to use at least 3 icons so that the ScaleButton
reflects the current value of
the scale better for the users.
Since 2.12
Signals
scaleButtonPopdown :: ScaleButtonClass self => Signal self (IO ())Source
The popdown
signal is a keybinding signal which gets emitted to popdown the scale widget.
The default binding for this signal is Escape.
scaleButtonPopup :: ScaleButtonClass self => Signal self (IO ())Source
The popup
signal is a keybinding signal which gets emitted to popup the scale widget.
The default bindings for this signal are Space, Enter and Return.
scaleButtonValueChanged :: ScaleButtonClass self => Signal self (Double -> IO ())Source
The scaleButtonValueChanged
signal is emitted when the value field has changed.