gtk-0.12.4: Binding to the Gtk+ graphical user interface library.

Portabilityportable (depends on GHC)
Stabilityprovisional
Maintainergtk2hs-users@lists.sourceforge.net
Safe HaskellNone

Graphics.UI.Gtk.Selectors.ColorButton

Contents

Description

A button to launch a color selection dialog

  • Module available since Gtk+ version 2.4

Synopsis

Detail

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

Class Hierarchy

 | GObject
 | +----Object
 | +----Widget
 | +----Container
 | +----Bin
 | +----Button
 | +----ColorButton

Types

Constructors

colorButtonNew :: IO ColorButtonSource

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.

colorButtonNewWithColorSource

Arguments

:: Color

color - A Color to set the current color with.

-> IO ColorButton 

Creates a new color button.

Methods

colorButtonSetColorSource

Arguments

:: ColorButtonClass self 
=> self 
-> Color

color - A Color to set the current color with.

-> IO () 

Sets the current color to be color.

colorButtonGetColor :: ColorButtonClass self => self -> IO ColorSource

Returns the current color value.

colorButtonSetAlphaSource

Arguments

:: ColorButtonClass self 
=> self 
-> Word16

alpha - an integer between 0 and 65535.

-> IO () 

Sets the current opacity to be alpha.

colorButtonGetAlphaSource

Arguments

:: ColorButtonClass self 
=> self 
-> IO Word16

returns an integer between 0 and 65535.

Returns the current alpha value.

colorButtonSetUseAlphaSource

Arguments

:: ColorButtonClass self 
=> self 
-> Bool

useAlpha - True if color button should use alpha channel, False if not.

-> IO () 

Sets whether or not the color button should use the alpha channel.

colorButtonGetUseAlphaSource

Arguments

:: ColorButtonClass self 
=> self 
-> IO Bool

returns True if the color sample uses alpha channel, False if not.

Does the color selection dialog use the alpha channel?

colorButtonSetTitleSource

Arguments

:: ColorButtonClass self 
=> self 
-> String

title - String containing new window title.

-> IO () 

Sets the title for the color selection dialog.

colorButtonGetTitleSource

Arguments

:: ColorButtonClass self 
=> self 
-> IO String

returns An internal string, do not free the return value

Gets the title of the color selection dialog.

Attributes

colorButtonUseAlpha :: ColorButtonClass self => Attr self BoolSource

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.

Default value: False

colorButtonTitle :: ColorButtonClass self => Attr self StringSource

The title of the color selection dialog

Default value: "Pick a Color"

colorButtonAlpha :: ColorButtonClass self => Attr self Word16Source

The selected opacity value (0 fully transparent, 65535 fully opaque).

Allowed values: <= 65535

Default value: 65535

Signals

onColorSet :: ColorButtonClass self => self -> IO () -> IO (ConnectId self)Source

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

afterColorSet :: ColorButtonClass self => self -> IO () -> IO (ConnectId self)Source

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