![]() |
![]() |
![]() |
Exo Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
#include <exo/exo.h> ExoIconBar; GtkWidget * exo_icon_bar_new (void
); GtkWidget * exo_icon_bar_new_with_model (GtkTreeModel *model
); GtkTreeModel * exo_icon_bar_get_model (ExoIconBar *icon_bar
); void exo_icon_bar_set_model (ExoIconBar *icon_bar
,GtkTreeModel *model
); gint exo_icon_bar_get_pixbuf_column (ExoIconBar *icon_bar
); void exo_icon_bar_set_pixbuf_column (ExoIconBar *icon_bar
,gint column
); gint exo_icon_bar_get_text_column (ExoIconBar *icon_bar
); void exo_icon_bar_set_text_column (ExoIconBar *icon_bar
,gint column
); GtkOrientation exo_icon_bar_get_orientation (ExoIconBar *icon_bar
); void exo_icon_bar_set_orientation (ExoIconBar *icon_bar
,GtkOrientation orientation
); gint exo_icon_bar_get_active (ExoIconBar *icon_bar
); void exo_icon_bar_set_active (ExoIconBar *icon_bar
,gint idx
); gboolean exo_icon_bar_get_active_iter (ExoIconBar *icon_bar
,GtkTreeIter *iter
); void exo_icon_bar_set_active_iter (ExoIconBar *icon_bar
,GtkTreeIter *iter
);
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... } |
typedef struct _ExoIconBar ExoIconBar;
The ExoIconBar struct contains only private fields and should not be directly accessed.
GtkWidget * exo_icon_bar_new (void
);
Creates a new ExoIconBar without model.
Returns : |
a newly allocated ExoIconBar. |
GtkWidget * exo_icon_bar_new_with_model (GtkTreeModel *model
);
Creates a new ExoIconBar and associates it with
model
.
|
A GtkTreeModel. |
Returns : |
a newly allocated ExoIconBar, which is associated 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.
|
A ExoIconBar. |
Returns : |
A GtkTreeModel, or NULL if none is currently being used. |
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.
|
A ExoIconBar. |
|
A GtkTreeModel or NULL . |
gint exo_icon_bar_get_pixbuf_column (ExoIconBar *icon_bar
);
Returns the column with pixbufs for icon_bar
.
|
An ExoIconBar. |
Returns : |
the pixbuf column, or -1 if it's unset. |
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.
|
An ExoIconBar. |
|
A column in the currently used model. |
gint exo_icon_bar_get_text_column (ExoIconBar *icon_bar
);
Returns the column with text for icon_bar
.
|
An ExoIconBar. |
Returns : |
the text column, or -1 if it's unset. |
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.
|
An ExoIconBar. |
|
A column in the currently used model or -1 to
use no text in icon_bar . |
GtkOrientation exo_icon_bar_get_orientation (ExoIconBar *icon_bar
);
Retrieves the current orientation of the toolbar. See
exo_icon_bar_set_orientation()
.
|
An ExoIconBar. |
Returns : |
The orientation of icon_bar . |
void exo_icon_bar_set_orientation (ExoIconBar *icon_bar
,GtkOrientation orientation
);
Sets whether the icon_bar
should appear horizontally
or vertically.
|
An ExoIconBar. |
|
A new GtkOrientation. |
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.
|
An ExoIconBar. |
Returns : |
An integer which is 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
.
|
An ExoIconBar. |
|
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.
|
An ExoIconBar. |
|
An uninitialized GtkTreeIter. |
Returns : |
TRUE if iter was set. |
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.
|
An ExoIconBar. |
|
The GtkTreeIter. |