GI.Gtk.Objects.ColorButton

The ColorButton is a button which displays the currently selected color and allows to open a color selection dialog to change the color. It is suitable widget for selecting a color in a preference dialog.

CSS nodes

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

Exported types

newtype ColorButton

Memory-managed wrapper type.

Constructors

ColorButton (ManagedPtr ColorButton)

Instances

Eq ColorButton

Defined in GI.Gtk.Objects.ColorButton

Methods

(==) :: ColorButton -> ColorButton -> Bool

(/=) :: ColorButton -> ColorButton -> Bool

IsGValue ColorButton

Convert ColorButton to and from GValue with toGValue and fromGValue.

Defined in GI.Gtk.Objects.ColorButton

Methods

toGValue :: ColorButton -> IO GValue

fromGValue :: GValue -> IO ColorButton

ManagedPtrNewtype ColorButton

Defined in GI.Gtk.Objects.ColorButton

Methods

toManagedPtr :: ColorButton -> ManagedPtr ColorButton

TypedObject ColorButton

Defined in GI.Gtk.Objects.ColorButton

Methods

glibType :: IO GType

GObject ColorButton

Defined in GI.Gtk.Objects.ColorButton

HasParentTypes ColorButton

Defined in GI.Gtk.Objects.ColorButton

type ParentTypes ColorButton

Defined in GI.Gtk.Objects.ColorButton

type ParentTypes ColorButton = '[Widget, Object, ImplementorIface, Buildable, ColorChooser, ConstraintTarget]

class (GObject o, IsDescendantOf ColorButton o) => IsColorButton o

Type class for types which can be safely cast to ColorButton, for instance with toColorButton.

Instances

(GObject o, IsDescendantOf ColorButton o) => IsColorButton o

Defined in GI.Gtk.Objects.ColorButton

toColorButton :: (MonadIO m, IsColorButton o) => o -> m ColorButton

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

Methods

Overloaded methods

getModal

colorButtonGetModal

Arguments

:: (HasCallStack, MonadIO m, IsColorButton a)

=> a

button: a ColorButton

-> m Bool

Returns: True if the dialog is modal

Gets whether the dialog is modal.

getTitle

colorButtonGetTitle

Arguments

:: (HasCallStack, MonadIO m, IsColorButton a)

=> a

button: a ColorButton

-> m Text

Returns: An internal string, do not free the return value

Gets the title of the color selection dialog.

new

colorButtonNew

Arguments

:: (HasCallStack, MonadIO m)

=> m ColorButton

Returns: a new color button

Creates a new color button.

This returns a widget in the form of a small button containing a swatch representing the current selected color. When the button is clicked, a color-selection dialog will open, allowing the user to select a color. The swatch will be updated to reflect the new color when the user finishes.

newWithRgba

colorButtonNewWithRgba

Arguments

:: (HasCallStack, MonadIO m)

=> RGBA

rgba: A RGBA to set the current color with

-> m ColorButton

Returns: a new color button

Creates a new color button.

setModal

colorButtonSetModal

Arguments

:: (HasCallStack, MonadIO m, IsColorButton a)

=> a

button: a ColorButton

-> Bool

modal: True to make the dialog modal

-> m ()

Sets whether the dialog should be modal.

setTitle

colorButtonSetTitle

Arguments

:: (HasCallStack, MonadIO m, IsColorButton a)

=> a

button: a ColorButton

-> Text

title: String containing new window title

-> m ()

Sets the title for the color selection dialog.

Properties

modal

No description available in the introspection data.

constructColorButtonModal :: (IsColorButton o, MonadIO m) => Bool -> m (GValueConstruct o)

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

getColorButtonModal :: (MonadIO m, IsColorButton o) => o -> m Bool

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

get colorButton #modal

setColorButtonModal :: (MonadIO m, IsColorButton o) => o -> Bool -> m ()

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

set colorButton [ #modal := value ]

rgba

The RGBA color.

clearColorButtonRgba :: (MonadIO m, IsColorButton o) => o -> m ()

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

clear #rgba

constructColorButtonRgba :: (IsColorButton o, MonadIO m) => RGBA -> m (GValueConstruct o)

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

getColorButtonRgba :: (MonadIO m, IsColorButton o) => o -> m (Maybe RGBA)

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

get colorButton #rgba

setColorButtonRgba :: (MonadIO m, IsColorButton o) => o -> RGBA -> m ()

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

set colorButton [ #rgba := value ]

showEditor

Set this property to True to skip the palette in the dialog and go directly to the color editor.

This property should be used in cases where the palette in the editor would be redundant, such as when the color button is already part of a palette.

constructColorButtonShowEditor :: (IsColorButton o, MonadIO m) => Bool -> m (GValueConstruct o)

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

getColorButtonShowEditor :: (MonadIO m, IsColorButton o) => o -> m Bool

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

get colorButton #showEditor

setColorButtonShowEditor :: (MonadIO m, IsColorButton o) => o -> Bool -> m ()

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

set colorButton [ #showEditor := value ]

title

The title of the color selection dialog

constructColorButtonTitle :: (IsColorButton o, MonadIO m) => Text -> m (GValueConstruct o)

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

getColorButtonTitle :: (MonadIO m, IsColorButton o) => o -> m Text

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

get colorButton #title

setColorButtonTitle :: (MonadIO m, IsColorButton o) => o -> Text -> m ()

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

set colorButton [ #title := value ]

useAlpha

If this property is set to True, the color swatch on the button is rendered against a checkerboard background to show its opacity and the opacity slider is displayed in the color selection dialog.

constructColorButtonUseAlpha :: (IsColorButton o, MonadIO m) => Bool -> m (GValueConstruct o)

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

getColorButtonUseAlpha :: (MonadIO m, IsColorButton o) => o -> m Bool

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

get colorButton #useAlpha

setColorButtonUseAlpha :: (MonadIO m, IsColorButton o) => o -> Bool -> m ()

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

set colorButton [ #useAlpha := value ]

Signals

colorSet

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

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

type ColorButtonColorSetCallback = IO ()

The colorSet signal is emitted when the user selects a color. When handling this signal, use colorChooserGetRgba to find out which color was just selected.

Note that this signal is only emitted when the user changes the color. If you need to react to programmatic color changes as well, use the notify[color](#g:signal:color) signal.

afterColorButtonColorSet :: (IsColorButton a, MonadIO m) => a -> ColorButtonColorSetCallback -> m SignalHandlerId

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

after colorButton #colorSet callback

genClosure_ColorButtonColorSet :: MonadIO m => ColorButtonColorSetCallback -> m (GClosure C_ColorButtonColorSetCallback)

Wrap the callback into a GClosure.

mk_ColorButtonColorSetCallback :: C_ColorButtonColorSetCallback -> IO (FunPtr C_ColorButtonColorSetCallback)

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

noColorButtonColorSetCallback :: Maybe ColorButtonColorSetCallback

A convenience synonym for Nothing :: Maybe ColorButtonColorSetCallback.

onColorButtonColorSet :: (IsColorButton a, MonadIO m) => a -> ColorButtonColorSetCallback -> m SignalHandlerId

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

on colorButton #colorSet callback

wrap_ColorButtonColorSetCallback :: ColorButtonColorSetCallback -> C_ColorButtonColorSetCallback

Wrap a ColorButtonColorSetCallback into a C_ColorButtonColorSetCallback.