GimpColorProfileComboBox: GIMP Widgets Library Reference Manual

GimpColorProfileComboBox

GimpColorProfileComboBox — A combo box for selecting color profiles.

Functions

GtkWidget *	gimp_color_profile_combo_box_new ()
GtkWidget *	gimp_color_profile_combo_box_new_with_model ()
void	gimp_color_profile_combo_box_add ()
void	gimp_color_profile_combo_box_add_file ()
void	gimp_color_profile_combo_box_set_active ()
void	gimp_color_profile_combo_box_set_active_file ()
gchar *	gimp_color_profile_combo_box_get_active ()
GFile *	gimp_color_profile_combo_box_get_active_file ()

Properties

GtkDialog *	dialog	Read / Write / Construct Only
GimpColorProfileStore *	model	Read / Write

Types and Values

GimpColorProfileComboBox

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkObject
            ╰── GtkWidget
                ╰── GtkContainer
                    ╰── GtkBin
                        ╰── GtkComboBox
                            ╰── GimpColorProfileComboBox

Implemented Interfaces

GimpColorProfileComboBox implements AtkImplementorIface, GtkBuildable, GtkCellLayout and GtkCellEditable.

Description

A combo box for selecting color profiles.

Functions

gimp_color_profile_combo_box_new ()

GtkWidget *
gimp_color_profile_combo_box_new (GtkWidget *dialog,
                                  const gchar *history);

Create a combo-box widget for selecting color profiles. The combo-box is populated from the file specified as history . This filename is typically created using the following code snippet:

1	gchar *history = gimp_personal_rc_file ("profilerc");

The recommended dialog type to use is a GimpColorProfileChooserDialog. If a GimpColorProfileChooserDialog is passed, GimpColorProfileComboBox will take complete control over the dialog, which means connecting a GtkDialog::response() callback by itself, and take care of destroying the dialog when the combo box is destroyed.

If another type of dialog is passed, this has to be implemented separately.

Parameters

dialog	a GtkDialog to present when the user selects the "Select color profile from disk..." item
history	filename of the profilerc (or `NULL` for no history)

Returns

a new GimpColorProfileComboBox.

Since: 2.4

gimp_color_profile_combo_box_new_with_model ()

GtkWidget *
gimp_color_profile_combo_box_new_with_model
                               (GtkWidget *dialog,
                                GtkTreeModel *model);

This constructor is useful when you want to create several combo-boxes for profile selection that all share the same GimpColorProfileStore. This is for example done in the GIMP Preferences dialog.

Parameters

dialog	a GtkDialog to present when the user selects the "Select color profile from disk..." item
model	a GimpColorProfileStore object

Returns

a new GimpColorProfileComboBox.

Since: 2.4

gimp_color_profile_combo_box_add ()

void
gimp_color_profile_combo_box_add (GimpColorProfileComboBox *combo,
                                  const gchar *filename,
                                  const gchar *label);

gimp_color_profile_combo_box_add is deprecated and should not be used in newly-written code.

use gimp_color_profile_combo_box_add_file() instead.

This function delegates to the underlying GimpColorProfileStore. Please refer to the documentation of gimp_color_profile_store_add_file() for details.

Parameters

combo	a GimpColorProfileComboBox
filename	filename of the profile to add (or `NULL`)
label	label to use for the profile (may only be `NULL` if `filename` is `NULL`)

Since: 2.4

gimp_color_profile_combo_box_add_file ()

void
gimp_color_profile_combo_box_add_file (GimpColorProfileComboBox *combo,
                                       GFile *file,
                                       const gchar *label);

This function delegates to the underlying GimpColorProfileStore. Please refer to the documentation of gimp_color_profile_store_add_file() for details.

Parameters

combo	a GimpColorProfileComboBox
file	file of the profile to add (or `NULL`)
label	label to use for the profile (may only be `NULL` if `file` is `NULL`)

Since: 2.10

gimp_color_profile_combo_box_set_active ()

void
gimp_color_profile_combo_box_set_active
                               (GimpColorProfileComboBox *combo,
                                const gchar *filename,
                                const gchar *label);

gimp_color_profile_combo_box_set_active is deprecated and should not be used in newly-written code.

use gimp_color_profile_combo_box_set_active_file() instead.

Selects a color profile from the combo and makes it the active item. If the profile is not listed in the combo , then it is added with the given label (or filename in case that label is NULL).

Parameters

combo	a GimpColorProfileComboBox
filename	filename of the profile to select
label	label to use when adding a new entry (can be `NULL`)

Since: 2.4

gimp_color_profile_combo_box_set_active_file ()

void
gimp_color_profile_combo_box_set_active_file
                               (GimpColorProfileComboBox *combo,
                                GFile *file,
                                const gchar *label);

Selects a color profile from the combo and makes it the active item. If the profile is not listed in the combo , then it is added with the given label (or file in case that label is NULL).

Parameters

combo	a GimpColorProfileComboBox
file	file of the profile to select
label	label to use when adding a new entry (can be `NULL`)

Since: 2.10

gimp_color_profile_combo_box_get_active ()

gchar *
gimp_color_profile_combo_box_get_active
                               (GimpColorProfileComboBox *combo);

gimp_color_profile_combo_box_get_active is deprecated and should not be used in newly-written code.

use gimp_color_profile_combo_box_get_active_file() instead.

Parameters

combo

a GimpColorProfileComboBox

Returns

The filename of the currently selected color profile, This is a newly allocated string and should be released using g_free() when it is not any longer needed.

Since: 2.4

gimp_color_profile_combo_box_get_active_file ()

GFile *
gimp_color_profile_combo_box_get_active_file
                               (GimpColorProfileComboBox *combo);

Parameters

combo

a GimpColorProfileComboBox

Returns

The file of the currently selected color profile, release using g_object_unref() when it is not any longer needed.

Since: 2.10

Types and Values