HeColorDialog

HeColorDialog — A dialog to allow the user to select colors

Synopsis

                    HeColorDialogPrivate;
                    HeColorDialog;
GtkWidget*          he_color_dialog_new                 (void);
void                he_color_dialog_get_color           (HeColorDialog *cd,
                                                         GdkColor *color);
void                he_color_dialog_set_color           (HeColorDialog *cd,
                                                         GdkColor *color);
GdkColor*           he_color_dialog_present             (GtkWindow *parent,
                                                         GdkColor *default_color,
                                                         gchar *title);
GdkColor*           he_color_dialog_present_interop     (GdkNativeWindow parent_winid,
                                                         GdkColor *default_color,
                                                         gchar *title);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkWindow
                                       +----GtkDialog
                                             +----HeColorDialog

Implemented Interfaces

HeColorDialog implements AtkImplementorIface and GtkBuildable.

Description

HeColorDialog enables the user to select an arbitrary color from a HSV colorspace.

Details

HeColorDialogPrivate

typedef struct _HeColorDialogPrivate HeColorDialogPrivate;


HeColorDialog

typedef struct _HeColorDialog HeColorDialog;


he_color_dialog_new ()

GtkWidget*          he_color_dialog_new                 (void);

Creates a new HeColorDialog

Returns : a new HeColorDialog

Since 2.2


he_color_dialog_get_color ()

void                he_color_dialog_get_color           (HeColorDialog *cd,
                                                         GdkColor *color);

cd : the HeColorDialog
color : a GdkColor to be filled with the current color

Since 2.2


he_color_dialog_set_color ()

void                he_color_dialog_set_color           (HeColorDialog *cd,
                                                         GdkColor *color);

Sets the current color on the HeColorDialog widget

cd : the HeColorDialog
color : the color to set

Since 2.2


he_color_dialog_present ()

GdkColor*           he_color_dialog_present             (GtkWindow *parent,
                                                         GdkColor *default_color,
                                                         gchar *title);

Convenient method that presents the user with a HeColorDialog.

parent : Optional. The parent window of the dialog, or NULL.
default_color : Optional. The default GdkColor to be shown in the dialog, or NULL.
title : Optional. The title of the dialog window. (If NULL, the default title is used.)
Returns : a GdkColor* pointing to the selected color. If the dialog is cancelled, a copy of default_color is returned. (Or NULL, if default_color is NULL.) The caller is responsible for freeing the result using gdk_color_free().

he_color_dialog_present_interop ()

GdkColor*           he_color_dialog_present_interop     (GdkNativeWindow parent_winid,
                                                         GdkColor *default_color,
                                                         gchar *title);

Convenient method that presents the user with a HeColorDialog.

parent_winid : Optional. The parent native window of the dialog, or 0.
default_color : Optional. The default GdkColor to be shown in the dialog, or NULL.
title : Optional. The title of the dialog window. (If NULL, the default title is used.)
Returns : a GdkColor* pointing to the selected color. If the dialog is cancelled, a copy of default_color is returned. (Or NULL, if default_color is NULL.) The caller is responsible for freeing the returned pointer's memory.

See Also

HeColorSelector, HeColorButton