Top |
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 |
Object Hierarchy
GObject ╰── GInitiallyUnowned ╰── GtkObject ╰── GtkWidget ╰── GtkContainer ╰── GtkBin ╰── GtkComboBox ╰── GimpColorProfileComboBox
Implemented Interfaces
GimpColorProfileComboBox implements AtkImplementorIface, GtkBuildable, GtkCellLayout and GtkCellEditable.
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 |
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 |
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 |
||
filename |
filename of the profile to add (or |
|
label |
label to use for the profile
(may only be |
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 |
||
file |
file of the profile to add (or |
|
label |
label to use for the profile
(may only be |
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 |
||
filename |
filename of the profile to select |
|
label |
label to use when adding a new entry (can be |
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 |
||
file |
file of the profile to select |
|
label |
label to use when adding a new entry (can be |
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.
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
);
Returns
The file of the currently selected color profile,
release using g_object_unref()
when it is not any
longer needed.
Since: 2.10
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