|
|
|
hildon 2.1.42 Reference Manual | |
|---|---|---|---|---|
HildonBreadCrumbTrailHildonBreadCrumbTrail — Widget used to represent a specific path in a hierarchical tree. Stability: Unstable |
HildonBreadCrumbTrail;
GtkWidget* hildon_bread_crumb_trail_new (void);
void hildon_bread_crumb_trail_push (HildonBreadCrumbTrail *bct,
HildonBreadCrumb *item,
gpointer id,
GDestroyNotify destroy);
void hildon_bread_crumb_trail_push_text (HildonBreadCrumbTrail *bct,
const gchar *text,
gpointer id,
GDestroyNotify destroy);
void hildon_bread_crumb_trail_push_icon (HildonBreadCrumbTrail *bct,
const gchar *text,
GtkWidget *icon,
gpointer id,
GDestroyNotify destroy);
void hildon_bread_crumb_trail_pop (HildonBreadCrumbTrail *bct);
void hildon_bread_crumb_trail_clear (HildonBreadCrumbTrail *bct);
HildonBreadCrumbTrail is a GTK widget used to represent the currently active path in some kind of hierarchical structure (file system, media library, structured document, etc).
It has built-in support for text and icon bread crumbs, but the trail only requires a very simple interface to be implemented for its children and thus new types of items can be implemented if needed. See HildonBreadCrumb for more details.
typedef struct {
GtkContainer parent;
HildonBreadCrumbTrailPrivate *priv;
} HildonBreadCrumbTrail;
HildonBreadCrumbTrail is deprecated and should not be used in newly-written code.
GtkWidget* hildon_bread_crumb_trail_new (void);
hildon_bread_crumb_trail_new is deprecated and should not be used in newly-written code.
Creates a new HildonBreadCrumbTrail widget.
| Returns : | a GtkWidget pointer of newly created bread crumb trail widget |
Stability Level: Unstable
void hildon_bread_crumb_trail_push (HildonBreadCrumbTrail *bct, HildonBreadCrumb *item, gpointer id, GDestroyNotify destroy);
hildon_bread_crumb_trail_push is deprecated and should not be used in newly-written code.
Adds a new bread crumb to the end of the trail.
bct : |
pointer to HildonBreadCrumbTrail |
item : |
the HildonBreadCrumb to be added to the trail |
id : |
optional id for the bread crumb |
destroy : |
GDestroyNotify callback to be called when the bread crumb is destroyed |
Stability Level: Unstable
void hildon_bread_crumb_trail_push_text (HildonBreadCrumbTrail *bct, const gchar *text, gpointer id, GDestroyNotify destroy);
hildon_bread_crumb_trail_push_text is deprecated and should not be used in newly-written code.
Adds a new bread crumb to the end of the trail containing the specified text.
bct : |
pointer to HildonBreadCrumbTrail |
text : |
content of the new bread crumb |
id : |
optional id for the bread crumb |
destroy : |
GDestroyNotify callback to be called when the bread crumb is destroyed |
Stability Level: Unstable
void hildon_bread_crumb_trail_push_icon (HildonBreadCrumbTrail *bct, const gchar *text, GtkWidget *icon, gpointer id, GDestroyNotify destroy);
hildon_bread_crumb_trail_push_icon is deprecated and should not be used in newly-written code.
Adds a new bread crumb to the end of the trail containing the specified text and icon.
bct : |
pointer to HildonBreadCrumbTrail |
text : |
content of the new bread crumb |
icon : |
a widget to set as the icon in the bread crumb |
id : |
optional id for the bread crumb |
destroy : |
GDestroyNotify callback to be called when the bread crumb is destroyed |
Stability Level: Unstable
void hildon_bread_crumb_trail_pop (HildonBreadCrumbTrail *bct);
hildon_bread_crumb_trail_pop is deprecated and should not be used in newly-written code.
Removes the last bread crumb from the trail.
bct : |
pointer to HildonBreadCrumbTrail |
Stability Level: Unstable
void hildon_bread_crumb_trail_clear (HildonBreadCrumbTrail *bct);
hildon_bread_crumb_trail_clear is deprecated and should not be used in newly-written code.
Removes all the bread crumbs from the bread crumb trail.
bct : |
pointer to HildonBreadCrumbTrail |
Stability Level: Unstable