GtkColorButton

Description

A button to launch a color selection dialog

Methods and Functions

gtkColorButtonNew(show = TRUE)
gtkColorButtonNewWithColor(color, show = TRUE)
gtkColorButtonSetColor(object, color)
gtkColorButtonGetColor(object, color)
gtkColorButtonSetAlpha(object, alpha)
gtkColorButtonGetAlpha(object)
gtkColorButtonSetUseAlpha(object, use.alpha)
gtkColorButtonGetUseAlpha(object)
gtkColorButtonSetTitle(object, title)
gtkColorButtonGetTitle(object)
gtkColorButton(color, show = TRUE)

Hierarchy

  GObject
   +----GtkObject
         +----GtkWidget
               +----GtkContainer
                     +----GtkBin
                           +----GtkButton
                                 +----GtkColorButton

Interfaces

GtkColorButton implements AtkImplementorIface.

Detailed Description

The GtkColorButton 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.

Structures

GtkColorButton

undocumented

Convenient Construction

gtkColorButton is the result of collapsing the constructors of GtkColorButton (gtkColorButtonNew, gtkColorButtonNewWithColor) and accepts a subset of its arguments matching the required arguments of one of its delegate constructors.

Signals

color-set(widget, user.data)

The ::color-set signal is emitted when the user selects a color. When handling this signal, use gtkColorButtonGetColor and gtkColorButtonGetAlpha to find out which color was just selected.

Since 2.4

widget

[GtkColorButton] the object which received the signal.

user.data

[R object] user data set when the signal handler was connected.

Properties

alpha [numeric : Read / Write]

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

Allowed values: <= 65535 Default value: 65535 Since 2.4

color [GdkColor : Read / Write]

The selected color.

Since 2.4

title [character : Read / Write]

The title of the color selection dialog

Default value: "Pick a Color" Since 2.4

use-alpha [logical : Read / Write]

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 Since 2.4

Author(s)

Derived by RGtkGen from GTK+ documentation

References

http://developer.gnome.org/doc/API/2.0/gtk/GtkColorButton.html

See Also

GtkColorSelectionDialog GtkFontButton