GtkColorCombo

GtkColorCombo — A color combo widget for GTK.

Synopsis


#include <gtkextra.h>

                    GtkColorCombo;
GtkWidget *         gtk_color_combo_new                 (void);
GtkWidget *         gtk_color_combo_new_with_values     (gint nrows,
                                                         gint ncols,
                                                         GdkColor *colors);
void                gtk_color_combo_construct           (GtkColorCombo *color_combo);
void                gtk_color_combo_construct_with_values
                                                        (GtkColorCombo *color_combo,
                                                         gint nrows,
                                                         gint ncols,
                                                         GdkColor *colors);
GdkColor            gtk_color_combo_get_color_at        (GtkColorCombo *color_combo,
                                                         gint row,
                                                         gint col);
void                gtk_color_combo_find_color          (GtkColorCombo *color_combo,
                                                         GdkColor *color,
                                                         gint *row,
                                                         gint *col);
GdkColor            gtk_color_combo_get_selection       (GtkColorCombo *combo);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBox
                                 +----GtkHBox
                                       +----GtkComboButton
                                             +----GtkColorCombo

Implemented Interfaces

GtkColorCombo implements AtkImplementorIface, GtkBuildable and GtkOrientable.

Signals

  "changed"                                        : Run First

Description

A GtkColorCombo is a GtkCOmbo which contains all kinds of colors.

Details

GtkColorCombo

typedef struct _GtkColorCombo GtkColorCombo;

The GtkColorCombo struct contains only private data. It should only be accessed through the functions described below.


gtk_color_combo_new ()

GtkWidget *         gtk_color_combo_new                 (void);

Returns :


gtk_color_combo_new_with_values ()

GtkWidget *         gtk_color_combo_new_with_values     (gint nrows,
                                                         gint ncols,
                                                         GdkColor *colors);

Creates a new GtkColorCombo widget having nrows rows and ncols columns with GdkColor color.

nrows :

number of rows in GtkColorCombo.

ncols :

number of columns in GtkColorCombo.

colors :

GdkColor color.

Returns :

the newly-created GtkColorCombo widget.

gtk_color_combo_construct ()

void                gtk_color_combo_construct           (GtkColorCombo *color_combo);

Initialize a GtkColorCombo object.

color_combo :

the GtkColorCombo widget.

gtk_color_combo_construct_with_values ()

void                gtk_color_combo_construct_with_values
                                                        (GtkColorCombo *color_combo,
                                                         gint nrows,
                                                         gint ncols,
                                                         GdkColor *colors);

Initialize a GtkColorCombo object with specified values.

color_combo :

the GtkColorCombo widget.

nrows :

number of rows in GtkColorCombo.

ncols :

number of columns in GtkColorCombo.

colors :

GdkColor color.

gtk_color_combo_get_color_at ()

GdkColor            gtk_color_combo_get_color_at        (GtkColorCombo *color_combo,
                                                         gint row,
                                                         gint col);

Get the color in the combo at the specified row,column.

color_combo :

a GtkColorCombo widget.

row :

row number in GtkColorCombo.

col :

column number in GtkColorCombo.

Returns :

a GdkColor at row,col in color_combo

gtk_color_combo_find_color ()

void                gtk_color_combo_find_color          (GtkColorCombo *color_combo,
                                                         GdkColor *color,
                                                         gint *row,
                                                         gint *col);

Find the best match for a given color.

color_combo :

a GtkColorCombo widget.

color :

a GdkColor object.

row :

row number in GtkColorCombo.

col :

column number in GtkColorCombo.

gtk_color_combo_get_selection ()

GdkColor            gtk_color_combo_get_selection       (GtkColorCombo *combo);

Get the color in the combo at selection .

combo :

a GtkColorCombo widget.

Returns :

a GdkColor of the selection.

Signal Details

The "changed" signal

void                user_function                      (GtkColorCombo *colorcombo,
                                                        gint           arg1,
                                                        GdkColor      *arg2,
                                                        gpointer       user_data)       : Run First

colorcombo :

the object which received the signal.

arg1 :

arg2 :

user_data :

user data set when the signal handler was connected.