| Top | |
|
|
|
| gint | active | Read / Write |
| GtkTreeModel * | model | Read / Write |
| GtkOrientation | orientation | Read / Write |
| gint | pixbuf-column | Read / Write |
| gint | text-column | Read / Write |
| GdkColor * | active-item-border-color | Read |
| GdkColor * | active-item-fill-color | Read |
| GdkColor * | active-item-text-color | Read |
| GdkColor * | cursor-item-border-color | Read |
| GdkColor * | cursor-item-fill-color | Read |
| GdkColor * | cursor-item-text-color | Read |
GObject ╰── GInitiallyUnowned ╰── GtkObject ╰── GtkWidget ╰── GtkContainer ╰── ExoIconBar
A widget that displays any object that implements the GtkTreeModel interface in an icon bar.
Example 1. Creating a new ExoIconBar with a GtkListStore
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
enum { PIXBUF_COLUMN, STRING_COLUMN, N_COLUMNS, }; { GtkListStore *store; GtkWidget *bar; // make a new list store store = gtk_list_store_new (N_COLUMNS, GDK_TYPE_PIXBUF, G_TYPE_STRING); // fill the store with data fill_store (store); // create the icon bar bar = exo_icon_bar_new_with_model (GTK_TREE_MODEL (store)); exo_icon_bar_set_pixbuf_column (EXO_ICON_BAR (bar), PIXBUF_COLUMN); exo_icon_bar_set_text_column (EXO_ICON_BAR (bar), TEXT_COLUMN); gtk_widget_show (bar); // the icon bar keeps a reference on the store now g_object_unref (G_OBJECT (store)); // add the bar to your GUI now... } |
GtkWidget *
exo_icon_bar_new_with_model (GtkTreeModel *model);
Creates a new ExoIconBar and associates it with
model
.
GtkTreeModel *
exo_icon_bar_get_model (ExoIconBar *icon_bar);
Returns the model the ExoIconBar is based on. Returns NULL if
the model is unset.
void exo_icon_bar_set_model (ExoIconBar *icon_bar,GtkTreeModel *model);
Sets the model for a ExoIconBar. If the icon_bar
already has a model
set, it will remove it before settings the new model. If model
is NULL,
then it will unset the old model.
gint
exo_icon_bar_get_pixbuf_column (ExoIconBar *icon_bar);
Returns the column with pixbufs for icon_bar
.
void exo_icon_bar_set_pixbuf_column (ExoIconBar *icon_bar,gint column);
Sets the column with pixbufs for icon_bar
to be column
. The pixbuf
column must be of type GDK_TYPE_PIXBUF.
gint
exo_icon_bar_get_text_column (ExoIconBar *icon_bar);
Returns the column with text for icon_bar
.
void exo_icon_bar_set_text_column (ExoIconBar *icon_bar,gint column);
Sets the column with text for icon_bar
to be column
. The
text column must be of type G_TYPE_STRING.
icon_bar |
An ExoIconBar. |
|
column |
A column in the currently used model or -1 to
use no text in |
GtkOrientation
exo_icon_bar_get_orientation (ExoIconBar *icon_bar);
Retrieves the current orientation of the toolbar. See
exo_icon_bar_set_orientation().
void exo_icon_bar_set_orientation (ExoIconBar *icon_bar,GtkOrientation orientation);
Sets whether the icon_bar
should appear horizontally
or vertically.
gint
exo_icon_bar_get_active (ExoIconBar *icon_bar);
Returns the index of the currently active item, or -1 if there's no active item.
void exo_icon_bar_set_active (ExoIconBar *icon_bar,gint idx);
Sets the active item of icon_bar
to be the item at idx
.
icon_bar |
An ExoIconBar. |
|
idx |
An index in the model passed during construction, or -1 to have no active item. |
gboolean exo_icon_bar_get_active_iter (ExoIconBar *icon_bar,GtkTreeIter *iter);
Sets iter
to point to the current active item, if it exists.
void exo_icon_bar_set_active_iter (ExoIconBar *icon_bar,GtkTreeIter *iter);
Sets the current active item to be the one referenced by iter
. iter
must correspond to a path of depth one.
This can only be called if icon_bar
is associated with GtkTreeModel.
struct ExoIconBar;
The ExoIconBar struct contains only private fields and should not be directly accessed.
“active” property“active” gint
The item which is currently active.
Allowed values: >= -1
Default value: -1
Flags: Read / Write
Allowed values: >= -1
Default value: -1
“orientation” property“orientation” GtkOrientation
The orientation of the icon bar.
Default value: GTK_ORIENTATION_VERTICAL
Flags: Read / Write
Default value: GTK_ORIENTATION_VERTICAL
“pixbuf-column” property“pixbuf-column” gint
The ::pixbuf-column property contains the number of the model column containing the pixbufs which are displyed. The pixbuf column must be of type GDK_TYPE_PIXBUF. Setting this property to -1 turns off the display of pixbufs.
Flags: Read / Write
Allowed values: >= -1
Default value: -1
“text-column” property“text-column” gint
The ::text-column property contains the number of the model column containing the texts which are displayed. The text column must be of type G_TYPE_STRING. If this property is set to -1, no texts are displayed.
Flags: Read / Write
Allowed values: >= -1
Default value: -1
“active-item-border-color” style property“active-item-border-color” GdkColor *
Active item border color.
Flags: Read
“active-item-fill-color” style property“active-item-fill-color” GdkColor *
Active item fill color.
Flags: Read
“active-item-text-color” style property“active-item-text-color” GdkColor *
Active item text color.
Flags: Read
“cursor-item-border-color” style property“cursor-item-border-color” GdkColor *
Cursor item border color.
Flags: Read
“cursor-item-fill-color” style property“cursor-item-fill-color” GdkColor *
Cursor item fill color.
Flags: Read
“cursor-item-text-color” style property“cursor-item-text-color” GdkColor *
Cursor item text color.
Flags: Read
“selection-changed” signalvoid user_function (ExoIconBar *icon_bar, gpointer user_data)
This signal is emitted whenever the currently selected icon changes.
Flags: Run First
“set-scroll-adjustments” signalvoid user_function (ExoIconBar *icon_bar, GtkAdjustment *hadjustment, GtkAdjustment *vadjustment, gpointer user_data)
Used internally to make the ExoIconBar scrollable.
icon_bar |
The ExoIconBar. |
|
hadjustment |
The horizontal adjustment. |
|
vadjustment |
The vertical adjustment. |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last