Context popup widget.
A ctxpopup is a widget that, when shown, pops up a list of items. It automatically chooses an area inside its parent object's view (set via elm_ctxpopup_add() and elm_ctxpopup_hover_parent_set()) to optimally fit into it. In the default theme, it will also point an arrow to it's top left position at the time one shows it. Ctxpopup items have a label and/or an icon. It is intended for a small number of items (hence the use of list, not genlist).
This widget inherits from the Layout one, so that all the functions acting on it also work for context popup objects (since 1.8).
This widget emits the following signals, besides the ones sent from Layout:
"dismissed"- This is called when 1. the outside of ctxpopup was clicked or 2. its parent area is changed or 3. the language is changed and also when 4. the parent object is resized due to the window rotation. Then ctxpopup is dismissed."language,changed"- This is called when the program's language is changed."focused"- When the ctxpopup has received focus. (since 1.8)"unfocused"- When the ctxpopup has lost focus. (since 1.8)"geometry,update"- When the ctxpopup geometry is updated. This smart event passes the ctxpopup geometry information with the given event_info argument which type is Evas_Coord_Rectangle. (since 1.18)
Default content parts of the ctxpopup widget that you can use for are:
- "default" - A content of the ctxpopup
Default content parts of the ctxpopup items that you can use for are:
- "icon" - An icon in the title area
Default text parts of the ctxpopup items that you can use for are:
- "default" - A title label in the title area
Supported elm_object common APIs.
Supported elm_object_item common APIs.
- elm_object_item_del
- elm_object_item_disabled_set
- elm_object_item_disabled_get
- elm_object_item_part_text_set
- elm_object_item_part_text_get
- elm_object_item_part_content_set
- elm_object_item_part_content_get
- elm_object_item_signal_emit
- elm_object_item_focus_set
- elm_object_item_focus_get
Ctxpopup example shows the usage of a good deal of the API.
Functions | |
| Evas_Object * | elm_ctxpopup_add (Evas_Object *parent) |
| Add a new Ctxpopup object to the parent. | |
Function Documentation
| Evas_Object* elm_ctxpopup_add | ( | Evas_Object * | parent | ) |
Add a new Ctxpopup object to the parent.
- Parameters:
-
parent Parent object
- Returns:
- New object or
NULL, if it cannot be created
- Since :
- 2.3
- Examples:
- ctxpopup_example_01.c.