GI.Gtk.Objects.ScaleButton

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.

CSS nodes

GtkScaleButton has a single CSS node with name button. To differentiate it from a plain Button, it gets the .scale style class.

Exported types

newtype ScaleButton

Memory-managed wrapper type.

Constructors

ScaleButton (ManagedPtr ScaleButton)

Instances

GObject ScaleButton

Defined in GI.Gtk.Objects.ScaleButton

Methods

gobjectType :: IO GType

HasParentTypes ScaleButton

Defined in GI.Gtk.Objects.ScaleButton

type ParentTypes ScaleButton

Defined in GI.Gtk.Objects.ScaleButton

type ParentTypes ScaleButton = Button ': (Bin ': (Container ': (Widget ': (Object ': (ImplementorIface ': (Actionable ': (Activatable ': (Buildable ': (Orientable ': ([] :: [Type]))))))))))

class (GObject o, IsDescendantOf ScaleButton o) => IsScaleButton o

Type class for types which can be safely cast to ScaleButton, for instance with toScaleButton.

Instances

(GObject o, IsDescendantOf ScaleButton o) => IsScaleButton o

Defined in GI.Gtk.Objects.ScaleButton

toScaleButton :: (MonadIO m, IsScaleButton o) => o -> m ScaleButton

Cast to ScaleButton, for types for which this is known to be safe. For general casts, use castTo.

noScaleButton :: Maybe ScaleButton

A convenience alias for Nothing :: Maybe ScaleButton.

Methods

getAdjustment

scaleButtonGetAdjustment

Arguments

:: (HasCallStack, MonadIO m, IsScaleButton a)

=> a

button: a ScaleButton

-> m Adjustment

Returns: the adjustment associated with the scale

Gets the Adjustment associated with the ScaleButton’s scale. See rangeGetAdjustment for details.

Since: 2.12

getMinusButton

scaleButtonGetMinusButton

Arguments

:: (HasCallStack, MonadIO m, IsScaleButton a)

=> a

button: a ScaleButton

-> m Button

Returns: the minus button of the ScaleButton as a Button

Retrieves the minus button of the ScaleButton.

Since: 2.14

getPlusButton

scaleButtonGetPlusButton

Arguments

:: (HasCallStack, MonadIO m, IsScaleButton a)

=> a

button: a ScaleButton

-> m Button

Returns: the plus button of the ScaleButton as a Button

Retrieves the plus button of the ScaleButton.

Since: 2.14

getPopup

scaleButtonGetPopup

Arguments

:: (HasCallStack, MonadIO m, IsScaleButton a)

=> a

button: a ScaleButton

-> m Widget

Returns: the popup of the ScaleButton

Retrieves the popup of the ScaleButton.

Since: 2.14

getValue

scaleButtonGetValue

Arguments

:: (HasCallStack, MonadIO m, IsScaleButton a)

=> a

button: a ScaleButton

-> m Double

Returns: current value of the scale button

Gets the current value of the scale button.

Since: 2.12

new

scaleButtonNew

Arguments

:: (HasCallStack, MonadIO m)

=> Int32

size: a stock icon size (IconSize)

-> Double

min: the minimum value of the scale (usually 0)

-> Double

max: the maximum value of the scale (usually 100)

-> Double

step: the stepping of value when a scroll-wheel event, or up/down arrow event occurs (usually 2)

-> Maybe [Text]

icons: a Nothing-terminated array of icon names, or Nothing if you want to set the list later with scaleButtonSetIcons

-> m ScaleButton

Returns: a new ScaleButton

Creates a ScaleButton, with a range between min and max, with a stepping of step.

Since: 2.12

setAdjustment

scaleButtonSetAdjustment

Arguments

:: (HasCallStack, MonadIO m, IsScaleButton a, IsAdjustment b)

=> a

button: a ScaleButton

-> b

adjustment: a Adjustment

-> m ()

Sets the Adjustment to be used as a model for the ScaleButton’s scale. See rangeSetAdjustment for details.

Since: 2.12

setIcons

scaleButtonSetIcons

Arguments

:: (HasCallStack, MonadIO m, IsScaleButton a)

=> a

button: a ScaleButton

-> [Text]

icons: a Nothing-terminated array of icon names

-> m ()

Sets the icons to be used by the scale button. For details, see the ScaleButton:icons property.

Since: 2.12

setValue

scaleButtonSetValue

Arguments

:: (HasCallStack, MonadIO m, IsScaleButton a)

=> a

button: a ScaleButton

-> Double

value: new value of the scale button

-> m ()

Sets the current value of the scale; if the value is outside the minimum or maximum range values, it will be clamped to fit inside them. The scale button emits the ScaleButton::value-changed signal if the value changes.

Since: 2.12

Properties

adjustment

No description available in the introspection data.

constructScaleButtonAdjustment :: (IsScaleButton o, IsAdjustment a) => a -> IO (GValueConstruct o)

Construct a GValueConstruct with valid value for the “adjustment” property. This is rarely needed directly, but it is used by new.

getScaleButtonAdjustment :: (MonadIO m, IsScaleButton o) => o -> m Adjustment

Get the value of the “adjustment” property. When overloading is enabled, this is equivalent to

get scaleButton #adjustment

setScaleButtonAdjustment :: (MonadIO m, IsScaleButton o, IsAdjustment a) => o -> a -> m ()

Set the value of the “adjustment” property. When overloading is enabled, this is equivalent to

set scaleButton [ #adjustment := value ]

icons

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

constructScaleButtonIcons :: IsScaleButton o => [Text] -> IO (GValueConstruct o)

Construct a GValueConstruct with valid value for the “icons” property. This is rarely needed directly, but it is used by new.

getScaleButtonIcons :: (MonadIO m, IsScaleButton o) => o -> m (Maybe [Text])

Get the value of the “icons” property. When overloading is enabled, this is equivalent to

get scaleButton #icons

setScaleButtonIcons :: (MonadIO m, IsScaleButton o) => o -> [Text] -> m ()

Set the value of the “icons” property. When overloading is enabled, this is equivalent to

set scaleButton [ #icons := value ]

size

No description available in the introspection data.

constructScaleButtonSize :: IsScaleButton o => IconSize -> IO (GValueConstruct o)

Construct a GValueConstruct with valid value for the “size” property. This is rarely needed directly, but it is used by new.

getScaleButtonSize :: (MonadIO m, IsScaleButton o) => o -> m IconSize

Get the value of the “size” property. When overloading is enabled, this is equivalent to

get scaleButton #size

setScaleButtonSize :: (MonadIO m, IsScaleButton o) => o -> IconSize -> m ()

Set the value of the “size” property. When overloading is enabled, this is equivalent to

set scaleButton [ #size := value ]

value

No description available in the introspection data.

constructScaleButtonValue :: IsScaleButton o => Double -> IO (GValueConstruct o)

Construct a GValueConstruct with valid value for the “value” property. This is rarely needed directly, but it is used by new.

getScaleButtonValue :: (MonadIO m, IsScaleButton o) => o -> m Double

Get the value of the “value” property. When overloading is enabled, this is equivalent to

get scaleButton #value

setScaleButtonValue :: (MonadIO m, IsScaleButton o) => o -> Double -> m ()

Set the value of the “value” property. When overloading is enabled, this is equivalent to

set scaleButton [ #value := value ]

Signals

popdown

type C_ScaleButtonPopdownCallback = Ptr () -> Ptr () -> IO ()

Type for the callback on the (unwrapped) C side.

type ScaleButtonPopdownCallback = IO ()

The ::popdown signal is a [keybinding signal][GtkBindingSignal] which gets emitted to popdown the scale widget.

The default binding for this signal is Escape.

Since: 2.12

afterScaleButtonPopdown :: (IsScaleButton a, MonadIO m) => a -> ScaleButtonPopdownCallback -> m SignalHandlerId

Connect a signal handler for the “popdown” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after scaleButton #popdown callback

genClosure_ScaleButtonPopdown :: MonadIO m => ScaleButtonPopdownCallback -> m (GClosure C_ScaleButtonPopdownCallback)

Wrap the callback into a GClosure.

mk_ScaleButtonPopdownCallback :: C_ScaleButtonPopdownCallback -> IO (FunPtr C_ScaleButtonPopdownCallback)

Generate a function pointer callable from C code, from a C_ScaleButtonPopdownCallback.

noScaleButtonPopdownCallback :: Maybe ScaleButtonPopdownCallback

A convenience synonym for Nothing :: Maybe ScaleButtonPopdownCallback.

onScaleButtonPopdown :: (IsScaleButton a, MonadIO m) => a -> ScaleButtonPopdownCallback -> m SignalHandlerId

Connect a signal handler for the “popdown” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on scaleButton #popdown callback

wrap_ScaleButtonPopdownCallback :: ScaleButtonPopdownCallback -> C_ScaleButtonPopdownCallback

Wrap a ScaleButtonPopdownCallback into a C_ScaleButtonPopdownCallback.

popup

type C_ScaleButtonPopupCallback = Ptr () -> Ptr () -> IO ()

Type for the callback on the (unwrapped) C side.

type ScaleButtonPopupCallback = IO ()

The ::popup signal is a [keybinding signal][GtkBindingSignal] which gets emitted to popup the scale widget.

The default bindings for this signal are Space, Enter and Return.

Since: 2.12

afterScaleButtonPopup :: (IsScaleButton a, MonadIO m) => a -> ScaleButtonPopupCallback -> m SignalHandlerId

Connect a signal handler for the “popup” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after scaleButton #popup callback

genClosure_ScaleButtonPopup :: MonadIO m => ScaleButtonPopupCallback -> m (GClosure C_ScaleButtonPopupCallback)

Wrap the callback into a GClosure.

mk_ScaleButtonPopupCallback :: C_ScaleButtonPopupCallback -> IO (FunPtr C_ScaleButtonPopupCallback)

Generate a function pointer callable from C code, from a C_ScaleButtonPopupCallback.

noScaleButtonPopupCallback :: Maybe ScaleButtonPopupCallback

A convenience synonym for Nothing :: Maybe ScaleButtonPopupCallback.

onScaleButtonPopup :: (IsScaleButton a, MonadIO m) => a -> ScaleButtonPopupCallback -> m SignalHandlerId

Connect a signal handler for the “popup” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on scaleButton #popup callback

wrap_ScaleButtonPopupCallback :: ScaleButtonPopupCallback -> C_ScaleButtonPopupCallback

Wrap a ScaleButtonPopupCallback into a C_ScaleButtonPopupCallback.

valueChanged

type C_ScaleButtonValueChangedCallback = Ptr () -> CDouble -> Ptr () -> IO ()

Type for the callback on the (unwrapped) C side.

type ScaleButtonValueChangedCallback

Arguments

 = Double

value: the new value

-> IO ()

The ::value-changed signal is emitted when the value field has changed.

Since: 2.12

afterScaleButtonValueChanged :: (IsScaleButton a, MonadIO m) => a -> ScaleButtonValueChangedCallback -> m SignalHandlerId

Connect a signal handler for the “value-changed” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after scaleButton #valueChanged callback

genClosure_ScaleButtonValueChanged :: MonadIO m => ScaleButtonValueChangedCallback -> m (GClosure C_ScaleButtonValueChangedCallback)

Wrap the callback into a GClosure.

mk_ScaleButtonValueChangedCallback :: C_ScaleButtonValueChangedCallback -> IO (FunPtr C_ScaleButtonValueChangedCallback)

Generate a function pointer callable from C code, from a C_ScaleButtonValueChangedCallback.

noScaleButtonValueChangedCallback :: Maybe ScaleButtonValueChangedCallback

A convenience synonym for Nothing :: Maybe ScaleButtonValueChangedCallback.

onScaleButtonValueChanged :: (IsScaleButton a, MonadIO m) => a -> ScaleButtonValueChangedCallback -> m SignalHandlerId

Connect a signal handler for the “value-changed” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on scaleButton #valueChanged callback

wrap_ScaleButtonValueChangedCallback :: ScaleButtonValueChangedCallback -> C_ScaleButtonValueChangedCallback

Wrap a ScaleButtonValueChangedCallback into a C_ScaleButtonValueChangedCallback.