GimpColorProfileComboBox

GimpColorProfileComboBox — A combo box for selecting color profiles.

Functions

Properties

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

Types and Values

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.

See also gimp_color_profile_combo_box_new_with_model().

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.

See also gimp_color_profile_combo_box_new().

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

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

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

GimpColorProfileComboBox

typedef struct _GimpColorProfileComboBox GimpColorProfileComboBox;

Property Details

The “dialog” property

  “dialog”                   GtkDialog *

GtkDialog to present when the user selects the "Select color profile from disk..." item.

Owner: GimpColorProfileComboBox

Flags: Read / Write / Construct Only

Since: 2.4


The “model” property

  “model”                    GimpColorProfileStore *

Overrides the "model" property of the GtkComboBox class. GimpColorProfileComboBox requires the model to be a GimpColorProfileStore.

Owner: GimpColorProfileComboBox

Flags: Read / Write

Since: 2.4