GtkColorButton — A button to launch a color selection dialog
GtkWidget * | gtk_color_button_new () |
GtkWidget * | gtk_color_button_new_with_rgba () |
void | gtk_color_button_set_title () |
const char * | gtk_color_button_get_title () |
void | gtk_color_button_set_modal () |
gboolean | gtk_color_button_get_modal () |
gboolean | modal | Read / Write |
gboolean | show-editor | Read / Write |
char * | title | Read / Write |
void | color-set | Run First |
GObject ╰── GInitiallyUnowned ╰── GtkWidget ╰── GtkColorButton
GtkColorButton implements GtkAccessible, GtkBuildable, GtkConstraintTarget and GtkColorChooser.
#include <gtk/gtk.h>
The GtkColorButton 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.
GtkColorButton has a single CSS node with name button. To differentiate it from a plain GtkButton, it gets the .color style class.
GtkWidget *
gtk_color_button_new (void
);
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.
a new color button
GtkWidget *
gtk_color_button_new_with_rgba (const GdkRGBA *rgba
);
Creates a new color button.
rgba | A GdkRGBA to set the current color with |
a new color button
void gtk_color_button_set_title (GtkColorButton *button
,const char *title
);
Sets the title for the color selection dialog.
button | ||
title | String containing new window title |
const char *
gtk_color_button_get_title (GtkColorButton *button
);
Gets the title of the color selection dialog.
button |
An internal string, do not free the return value
void gtk_color_button_set_modal (GtkColorButton *button
,gboolean modal
);
Sets whether the dialog should be modal.
button | ||
modal |
|
gboolean
gtk_color_button_get_modal (GtkColorButton *button
);
Gets whether the dialog is modal.
button |
TRUE
if the dialog is modal
typedef struct _GtkColorButton GtkColorButton;
“modal”
property“modal” gboolean
Whether the dialog is modal.
Owner: GtkColorButton
Flags: Read / Write
Default value: TRUE
“show-editor”
property“show-editor” gboolean
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.
Owner: GtkColorButton
Flags: Read / Write
Default value: FALSE
“title”
property“title” char *
The title of the color selection dialog
Owner: GtkColorButton
Flags: Read / Write
Default value: "Pick a Color"
“color-set”
signalvoid user_function (GtkColorButton *widget, gpointer user_data)
The ::color-set signal is emitted when the user selects a color. When handling this signal, use gtk_color_chooser_get_rgba()
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.
widget | the object which received the signal. | |
user_data | user data set when the signal handler was connected. |
Flags: Run First
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk4/4.0/GtkColorButton.html