Naviframe Container
A naviframe widget consists of a stack of views. New views are pushed on top of previous ones, and only the top-most view on the stack is displayed. The previous views are not deleted. A previous view is displayed when the view on top of it is popped. Transitions can be animated on a push or a pop, depending on the theme applied to the widget.
Table of Contents
Related Info
Creating a Naviframe
To create a naviframe, use the elm_naviframe_add() function:
Evas_Object *nav = elm_naviframe_add(parent);;
Addind and Deleting Views
The naviframe is a stack of views. A new view is always pushed to the top of the stack. The top-most view is deleted by popping it.
To add a new view to the naviframe stack (and show it):
Elm_Object_Item *nav_it = elm_naviframe_item_push(nav, title_label, prev_button, next_button, view, item_style);
| Parameters | |
|---|---|
title_label | The label in the title area. The name of the title label part is âelm.text.titleâ |
prev_button | The button to go to the previous item. If it is NULL, then naviframe will create a back button automatically. The name of the prev_btn part is âelm.swallow.prev_btnâ |
next_button | The button to go to the next item. Or It could be just an extra function button. The name of the next_btn part is âelm.swallow.next_btnâ |
view | The main content object. The name of content part is âelm.swallow.contentâ |
item_style | The current item style name. NULL would be default. |
In fact, you can simply use elm_naviframe_item_push() with default
parameters:
Elm_Object_Item *nav_it = elm_naviframe_item_push(nav, NULL, NULL, NULL, view, NULL);
When you push a new view to the stack, you receive an Elm_Object_Item for the
view. You can use this item to modify the view.
The item pushed becomes one page of the naviframe, this item will be deleted
when it is popped with elm_naviframe_item_pop():
elm_naviframe_item_pop(nav);
Adding Fixed Content
The naviframe can also display fixed content on top of the current (top-most)
view. Use the elm_object_item_part_content_set() function to set this content.
Use the following part names to specify the location of the content:
âdefaultâ- The main content of the current pageâiconâ- An icon in the title area of the current pageâprev_btnâ- A button of the current page to go to the previous pageânext_btnâ- A button of the current page to go to the next page
For example, to add a button to the naviframe:
btn = elm_button_add(nav); elm_object_item_part_content_set(nav_it, "prev_btn", btn);
To set the title labels of the naviframe, use the
elm_object_item_part_text_set() function and specify one of the following
label locations:
âdefaultâ: Sets the title label in the title area of the current view.âsubtitleâ: Sets the subtitle label in the title area of the current view.
Signals
The naviframe emits the following signals:
âtransition,finishedâ- When the transition is finished in changing the itemâtitle,transition,finishedâ- When the title area's transition is finished in changing the state of the titleâtitle,clickedâ- User clicked title areaâfocusedâ- When the naviframe has received focus. (since 1.8)âunfocusedâ- When the naviframe has lost focus. (since 1.8)âlanguage,changedâ- the program's language changed (since 1.9)