|
|
|
Hildon 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.
HildonBreadCrumbTrail is deprecated since hildon 2.2. You should instead use HildonStackableWindow to represent hierarchical structure in applications.
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