GtkColorButton {RGtk2} | R Documentation

## 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)`
`gtkColorButtonSetAlpha(object, alpha)`
`gtkColorButtonGetAlpha(object)`
`gtkColorButtonSetUseAlpha(object, use.alpha)`
`gtkColorButtonGetUseAlpha(object)`
`gtkColorButtonSetTitle(object, title)`
`gtkColorButtonGetTitle(object)`
`gtkColorButton(color, show = TRUE)`

### Hierarchy

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

### Interfaces

GtkColorButton implements AtkImplementorIface, `GtkBuildable` and `GtkActivatable`.

### 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`

  The GtkColorButton struct has only private fields and should not be used directly.

### 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.

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

  `widget`

    the object which received the signal.

  `user.data`

    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

https://developer.gnome.org/gtk2/stable/GtkColorButton.html

### See Also

`GtkColorSelectionDialog` `GtkFontButton`

[Package RGtk2 version 2.20.36.3 Index]