Hildon Reference Manual | ||||
---|---|---|---|---|
#include <hildon/hildon.h> HildonColorButton; GtkWidget* hildon_color_button_new (void); GtkWidget* hildon_color_button_new_with_color (const GdkColor *color); void hildon_color_button_get_color (HildonColorButton *button, GdkColor *color); void hildon_color_button_set_color (HildonColorButton *button, GdkColor *color); gboolean hildon_color_button_get_popup_shown (HildonColorButton *button); void hildon_color_button_popdown (HildonColorButton *button);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkButton +----HildonColorButton
HildonColorButton is a widget to open a HildonColorChooserDialog. The selected color is shown in the button. The selected color is a property of the button. The property name is "color" and its type is GtkColor.
Example 16. HildonColorButton example
HildonColorButton *cbutton; GtkColor *color; cbutton = hildon_color_button_new(); gtk_object_get( GTK_OBJECT(cbutton), "color", color );
typedef struct _HildonColorButton HildonColorButton;
HildonColorButton
is deprecated and should not be used in newly-written code.
GtkWidget* hildon_color_button_new (void);
hildon_color_button_new
is deprecated and should not be used in newly-written code.
Creates a new color button. This returns a widget in the form of a small button containing a swatch representing the 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.
Returns : | a new color button |
GtkWidget* hildon_color_button_new_with_color (const GdkColor *color);
hildon_color_button_new_with_color
is deprecated and should not be used in newly-written code.
Creates a new color button with color
as the initial color.
color : |
a GdkColor for the initial color |
Returns : | a new color button |
void hildon_color_button_get_color (HildonColorButton *button, GdkColor *color);
hildon_color_button_get_color
is deprecated and should not be used in newly-written code.
button : |
a HildonColorButton |
color : |
a color GdkColor to be fillled with the current color |
void hildon_color_button_set_color (HildonColorButton *button, GdkColor *color);
hildon_color_button_set_color
is deprecated and should not be used in newly-written code.
Sets the color selected by the button.
button : |
a HildonColorButton |
color : |
a color to be set |
gboolean hildon_color_button_get_popup_shown (HildonColorButton *button);
hildon_color_button_get_popup_shown
is deprecated and should not be used in newly-written code.
This function checks if the color button has the color selection dialog currently popped-up.
button : |
a HildonColorButton |
Returns : | TRUE if the dialog is popped-up (visible to user). |
void hildon_color_button_popdown (HildonColorButton *button);
hildon_color_button_popdown
is deprecated and should not be used in newly-written code.
If the color selection dialog is currently popped-up (visible) it will be popped-down (hidden).
button : |
a HildonColorButton |
"popup-shown"
property"popup-shown" gboolean : Read
If the color selection dialog is currently popped-up (visible)
Default value: FALSE
"setup-dialog"
signalvoid user_function (HildonColorButton *hildoncolorbutton, HildonColorChooserDialog *arg1, gpointer user_data) : Run Last
hildoncolorbutton : |
the object which received the signal. |
arg1 : |
|
user_data : |
user data set when the signal handler was connected. |