![]() |
![]() |
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.
Public Member Functions | ||||
ColorButton (const Gdk::Color& color) | ||||
Creates a new color button with a predefined color. | ||||
ColorButton () | ||||
Creates a new color button. | ||||
guint16 | get_alpha () const | |||
Returns the current alpha value. | ||||
Gdk::Color | get_color () const | |||
Returns a copy of the the current color. | ||||
Glib::ustring | get_title () const | |||
Gets the title of the color selection dialog. | ||||
bool | get_use_alpha () const | |||
Does the color selection dialog use the alpha channel? | ||||
const GtkColorButton* | gobj () const | |||
Provides access to the underlying C GtkObject. | ||||
GtkColorButton* | gobj () | |||
Provides access to the underlying C GtkObject. | ||||
void | set_alpha (guint16 alpha) | |||
Sets the current opacity to be alpha . | ||||
void | set_color (const Gdk::Color& color) | |||
Sets the current color to be color . | ||||
void | set_title (const Glib::ustring& title) | |||
Sets the title for the color selection dialog. | ||||
void | set_use_alpha (bool use_alpha=true) | |||
Sets whether or not the color button should use the alpha channel. | ||||
Glib::SignalProxy0<void> | signal_color_set () | |||
The color_set signal is emitted when the user selects a color. | ||||
virtual | ~ColorButton () | |||
Related Functions | ||||
(Note that these are not member functions.) | ||||
Gtk::ColorButton* | wrap (GtkColorButton* object, bool take_copy=false) | |||
|
virtual Gtk::ColorButton::~ColorButton | ( | ) | [virtual] |
Gtk::ColorButton::ColorButton | ( | ) |
Creates a new color button.
This creates 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.
Since: 2.4
Gtk::ColorButton::ColorButton | ( | const Gdk::Color& | color | ) | [explicit] |
Creates a new color button with a predefined color.
Same as Gtk::ColorButton::ColorButton(). Additionally takes a Gdk::Color and initializes the button with this color. Equivalent to calling set_color(color) after the default constructor.
color | A Gdk::Color to set the current color with. |
guint16 Gtk::ColorButton::get_alpha | ( | ) | const |
Returns the current alpha value.
Gdk::Color Gtk::ColorButton::get_color | ( | ) | const |
Returns a copy of the the current color.
Changes to the return value will have no effect on the Gtk::ColorButton.
Glib::ustring Gtk::ColorButton::get_title | ( | ) | const |
Gets the title of the color selection dialog.
bool Gtk::ColorButton::get_use_alpha | ( | ) | const |
Does the color selection dialog use the alpha channel?
true
if the color sample uses alpha channel, false
if not.const GtkColorButton* Gtk::ColorButton::gobj | ( | ) | const [inline] |
GtkColorButton* Gtk::ColorButton::gobj | ( | ) | [inline] |
void Gtk::ColorButton::set_alpha | ( | guint16 | alpha | ) |
Sets the current opacity to be alpha .
alpha | An integer between 0 and 65535. |
void Gtk::ColorButton::set_color | ( | const Gdk::Color& | color | ) |
void Gtk::ColorButton::set_title | ( | const Glib::ustring & | title | ) |
Sets the title for the color selection dialog.
title | String containing new window title. |
void Gtk::ColorButton::set_use_alpha | ( | bool | use_alpha = true |
) |
Sets whether or not the color button should use the alpha channel.
use_alpha | true if color button should use alpha channel, false if not. |
Glib::SignalProxy0< void > Gtk::ColorButton::signal_color_set | ( | ) |
The color_set signal is emitted when the user selects a color.
When handling this signal, use get_color() and get_alpha() to find out which color was just selected.
void color_set()
Gtk::ColorButton* wrap | ( | GtkColorButton * | object, | |
bool | take_copy = false | |||
) | [related] |
object | The C instance |
take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref. |