2017-08-09 20:19:34 -07:00
|
|
|
class Elm.Index (Efl.Ui.Layout, Efl.Ui.Direction,
|
2016-06-10 01:58:17 -07:00
|
|
|
Efl.Ui.Clickable, Efl.Ui.Selectable)
|
2014-03-23 04:49:26 -07:00
|
|
|
{
|
2016-11-23 02:46:01 -08:00
|
|
|
[[elementary index class]]
|
2016-05-12 09:06:04 -07:00
|
|
|
legacy_prefix: elm_index;
|
2014-03-23 04:49:26 -07:00
|
|
|
eo_prefix: elm_obj_index;
|
2016-05-17 09:14:47 -07:00
|
|
|
event_prefix: elm_index;
|
2015-05-07 09:32:53 -07:00
|
|
|
methods {
|
|
|
|
@property autohide_disabled {
|
2015-08-07 07:19:21 -07:00
|
|
|
[[Enable or disable auto hiding feature for a given index widget.]]
|
2014-03-23 04:49:26 -07:00
|
|
|
values {
|
2015-08-07 07:19:21 -07:00
|
|
|
disabled: bool; [[$true to disable auto hiding, $false to enable]]
|
2014-03-23 04:49:26 -07:00
|
|
|
}
|
|
|
|
}
|
2015-05-07 09:32:53 -07:00
|
|
|
@property omit_enabled {
|
2015-08-07 07:19:21 -07:00
|
|
|
[[Enable or disable omit feature for a given index widget.
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2015-08-07 07:19:21 -07:00
|
|
|
@since 1.8]]
|
2014-03-23 04:49:26 -07:00
|
|
|
values {
|
2015-08-07 07:19:21 -07:00
|
|
|
enabled: bool; [[$true to enable omit feature, $false to disable]]
|
2014-03-23 04:49:26 -07:00
|
|
|
}
|
|
|
|
}
|
2015-09-07 22:50:53 -07:00
|
|
|
@property standard_priority {
|
|
|
|
[[Control standard_priority group of index. Priority group will be shown as many items as it can, and other group will be shown one character only.
|
2015-08-04 06:55:18 -07:00
|
|
|
|
2015-08-07 07:19:21 -07:00
|
|
|
@since 1.16]]
|
2015-08-04 06:55:18 -07:00
|
|
|
values {
|
2015-08-07 07:19:21 -07:00
|
|
|
priority: int; [[$priority target priority value in index]]
|
2015-08-04 06:55:18 -07:00
|
|
|
}
|
|
|
|
}
|
2015-05-07 09:32:53 -07:00
|
|
|
@property delay_change_time {
|
2015-08-07 07:19:21 -07:00
|
|
|
[[Set a delay change time for index object.
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2015-08-07 07:19:21 -07:00
|
|
|
Note: delay time is 0.2 sec by default.]]
|
2014-03-23 04:49:26 -07:00
|
|
|
values {
|
2015-08-07 07:19:21 -07:00
|
|
|
dtime: double; [[The delay change time to set.]]
|
2014-03-23 04:49:26 -07:00
|
|
|
}
|
|
|
|
}
|
2015-05-07 09:32:53 -07:00
|
|
|
@property indicator_disabled {
|
2015-08-07 07:19:21 -07:00
|
|
|
[[Control the indicator as to be disabled.
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2015-08-07 07:19:21 -07:00
|
|
|
In Index widget, Indicator notes popup text, which shows a letter has been selecting.]]
|
2014-03-23 04:49:26 -07:00
|
|
|
values {
|
2015-08-07 07:19:21 -07:00
|
|
|
disabled: bool; [[$true to disable it, $false to enable it]]
|
2014-03-23 04:49:26 -07:00
|
|
|
}
|
|
|
|
}
|
2015-05-07 09:32:53 -07:00
|
|
|
@property item_level {
|
2015-08-07 07:19:21 -07:00
|
|
|
[[Set the items level for a given index widget.
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2015-08-07 07:19:21 -07:00
|
|
|
See: elm_index_item_level_get()]]
|
2014-03-23 04:49:26 -07:00
|
|
|
values {
|
2015-08-07 07:19:21 -07:00
|
|
|
level: int; [[$0 or $1, the currently implemented levels.]]
|
2014-03-23 04:49:26 -07:00
|
|
|
}
|
|
|
|
}
|
|
|
|
level_go {
|
2015-08-07 07:19:21 -07:00
|
|
|
[[Flush the changes made to the index items so they work correctly
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2015-08-07 07:19:21 -07:00
|
|
|
This flushes any changes made to items indicating the object is ready to
|
|
|
|
go. You should call this before any changes you expect to work. This
|
|
|
|
is similar to elm_list_go().
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2015-08-07 07:19:21 -07:00
|
|
|
Warning: If not called, it won't display the index properly.]]
|
2014-03-23 04:49:26 -07:00
|
|
|
params {
|
2015-08-07 07:19:21 -07:00
|
|
|
@in level: int; [[The index level (one of $0 or $1) where changes were made]]
|
2014-03-23 04:49:26 -07:00
|
|
|
}
|
|
|
|
}
|
|
|
|
item_prepend {
|
2015-08-07 07:19:21 -07:00
|
|
|
[[Prepend a new item on a given index widget.
|
2014-03-23 04:49:26 -07:00
|
|
|
|
|
|
|
|
2015-08-07 07:19:21 -07:00
|
|
|
Despite the most common usage of the $letter argument is for
|
|
|
|
single char strings, one could use arbitrary strings as index
|
|
|
|
entries.
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2015-08-07 07:19:21 -07:00
|
|
|
$item will be the pointer returned back on $"changed",
|
|
|
|
"delay,changed" and $"selected" smart events.]]
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2016-05-23 07:41:28 -07:00
|
|
|
return: Elm.Widget.Item; [[A handle to the item added or $NULL, on errors]]
|
2014-03-23 04:49:26 -07:00
|
|
|
params {
|
2016-05-31 08:02:26 -07:00
|
|
|
@in letter: string; [[Letter under which the item should be indexed]]
|
2015-08-07 07:19:21 -07:00
|
|
|
@in func: Evas_Smart_Cb @optional; [[The function to call when the item is selected.]]
|
2016-06-02 04:54:59 -07:00
|
|
|
@in data: const(void_ptr) @optional; [[The item data to set for the index's item]]
|
2014-03-23 04:49:26 -07:00
|
|
|
}
|
|
|
|
}
|
|
|
|
item_clear {
|
2015-08-07 07:19:21 -07:00
|
|
|
[[Removes all items from a given index widget.
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2015-08-07 07:19:21 -07:00
|
|
|
If deletion callbacks are set, via elm_object_item_del_cb_set(),
|
|
|
|
that callback function will be called for each item in $obj.]]
|
2014-03-23 04:49:26 -07:00
|
|
|
}
|
|
|
|
item_insert_after {
|
2015-08-07 07:19:21 -07:00
|
|
|
[[Insert a new item into the index object after item $after.
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2015-08-07 07:19:21 -07:00
|
|
|
Despite the most common usage of the $letter argument is for
|
|
|
|
single char strings, one could use arbitrary strings as index
|
|
|
|
entries.
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2015-08-07 07:19:21 -07:00
|
|
|
$item will be the pointer returned back on $"changed",
|
|
|
|
"delay,changed" and $"selected" smart events.
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2015-08-07 07:19:21 -07:00
|
|
|
Note: If $relative is $NULL this function will behave as
|
|
|
|
elm_index_item_append().]]
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2016-05-23 07:41:28 -07:00
|
|
|
return: Elm.Widget.Item; [[A handle to the item added or $NULL, on errors]]
|
2014-03-23 04:49:26 -07:00
|
|
|
params {
|
2016-05-23 07:41:28 -07:00
|
|
|
@in after: Elm.Widget.Item; [[The index item to insert after.]]
|
2016-05-31 08:02:26 -07:00
|
|
|
@in letter: string; [[Letter under which the item should be indexed]]
|
2015-08-07 07:19:21 -07:00
|
|
|
@in func: Evas_Smart_Cb @optional; [[The function to call when the item is clicked.]]
|
2016-06-02 04:54:59 -07:00
|
|
|
@in data: const(void_ptr) @optional; [[The item data to set for the index's item]]
|
2014-03-23 04:49:26 -07:00
|
|
|
}
|
|
|
|
}
|
|
|
|
item_find {
|
2015-08-07 07:19:21 -07:00
|
|
|
[[Find a given index widget's item, using item data.]]
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2016-05-23 07:41:28 -07:00
|
|
|
return: Elm.Widget.Item; [[The index item handle, if found, or $NULL otherwise]]
|
2014-03-23 04:49:26 -07:00
|
|
|
params {
|
2016-06-02 04:54:59 -07:00
|
|
|
@in data: const(void_ptr); [[The item data pointed to by the desired index item]]
|
2014-03-23 04:49:26 -07:00
|
|
|
}
|
|
|
|
}
|
|
|
|
item_insert_before {
|
2015-08-07 07:19:21 -07:00
|
|
|
[[Insert a new item into the index object before item $before.
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2015-08-07 07:19:21 -07:00
|
|
|
Despite the most common usage of the $letter argument is for
|
|
|
|
single char strings, one could use arbitrary strings as index
|
|
|
|
entries.
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2015-08-07 07:19:21 -07:00
|
|
|
$item will be the pointer returned back on $"changed",
|
|
|
|
"delay,changed" and $"selected" smart events.
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2015-08-07 07:19:21 -07:00
|
|
|
Note: If $relative is $NULL this function will behave as
|
|
|
|
elm_index_item_prepend().]]
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2016-05-23 07:41:28 -07:00
|
|
|
return: Elm.Widget.Item; [[A handle to the item added or $NULL, on errors]]
|
2014-03-23 04:49:26 -07:00
|
|
|
params {
|
2016-05-23 07:41:28 -07:00
|
|
|
@in before: Elm.Widget.Item; [[The index item to insert after.]]
|
2016-05-31 08:02:26 -07:00
|
|
|
@in letter: string; [[Letter under which the item should be indexed]]
|
2015-08-07 07:19:21 -07:00
|
|
|
@in func: Evas_Smart_Cb @optional; [[The function to call when the item is clicked.]]
|
2016-06-02 04:54:59 -07:00
|
|
|
@in data: const(void_ptr) @optional; [[The item data to set for the index's item]]
|
2014-03-23 04:49:26 -07:00
|
|
|
}
|
|
|
|
}
|
|
|
|
item_append {
|
2015-08-07 07:19:21 -07:00
|
|
|
[[Append a new item on a given index widget.
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2015-08-07 07:19:21 -07:00
|
|
|
Despite the most common usage of the $letter argument is for
|
|
|
|
single char strings, one could use arbitrary strings as index
|
|
|
|
entries.
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2015-08-07 07:19:21 -07:00
|
|
|
$item will be the pointer returned back on $"changed",
|
|
|
|
"delay,changed" and $"selected" smart events.]]
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2016-05-23 07:41:28 -07:00
|
|
|
return: Elm.Widget.Item; [[A handle to the item added or $NULL, on errors]]
|
2014-03-23 04:49:26 -07:00
|
|
|
params {
|
2016-05-31 08:02:26 -07:00
|
|
|
@in letter: string; [[Letter under which the item should be indexed]]
|
2015-08-07 07:19:21 -07:00
|
|
|
@in func: Evas_Smart_Cb @optional; [[The function to call when the item is selected.]]
|
2016-06-02 04:54:59 -07:00
|
|
|
@in data: const(void_ptr) @optional; [[The item data to set for the index's item]]
|
2014-03-23 04:49:26 -07:00
|
|
|
}
|
|
|
|
}
|
2014-07-22 09:13:52 -07:00
|
|
|
selected_item_get @const {
|
2015-08-07 07:19:21 -07:00
|
|
|
[[Returns the last selected item, for a given index widget.]]
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2016-05-23 07:41:28 -07:00
|
|
|
return: Elm.Widget.Item; [[The last item selected on $obj (or $NULL, on errors).]]
|
2014-03-23 04:49:26 -07:00
|
|
|
params {
|
2015-08-07 07:19:21 -07:00
|
|
|
@in level: int; [[$0 or $1, the currently implemented levels.]]
|
2014-03-23 04:49:26 -07:00
|
|
|
}
|
|
|
|
}
|
|
|
|
item_sorted_insert {
|
2015-08-07 07:19:21 -07:00
|
|
|
[[Insert a new item into the given index widget, using $cmp_func function to sort items (by item handles).
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2015-08-07 07:19:21 -07:00
|
|
|
Despite the most common usage of the $letter argument is for
|
|
|
|
single char strings, one could use arbitrary strings as index
|
|
|
|
entries.
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2015-08-07 07:19:21 -07:00
|
|
|
$item will be the pointer returned back on $"changed",
|
|
|
|
"delay,changed" and $"selected" smart events.]]
|
2014-03-23 04:49:26 -07:00
|
|
|
|
2016-05-23 07:41:28 -07:00
|
|
|
return: Elm.Widget.Item; [[A handle to the item added or $NULL, on errors]]
|
2014-03-23 04:49:26 -07:00
|
|
|
params {
|
2016-05-31 08:02:26 -07:00
|
|
|
@in letter: string; [[Letter under which the item should be indexed]]
|
2015-08-07 07:19:21 -07:00
|
|
|
@in func: Evas_Smart_Cb @optional; [[The function to call when the item is clicked.]]
|
2016-06-02 04:54:59 -07:00
|
|
|
@in data: const(void_ptr) @optional; [[The item data to set for the index's item]]
|
2015-08-07 07:19:21 -07:00
|
|
|
@in cmp_func: Eina_Compare_Cb; [[The comparing function to be used to sort index items by index item handles]]
|
|
|
|
@in cmp_data_func: Eina_Compare_Cb @optional; [[A fallback function to be called for the
|
|
|
|
sorting of index items by item data). It will be used
|
|
|
|
when $cmp_func returns $0 (equality), which means an index
|
|
|
|
item with provided item data already exists. To decide which
|
|
|
|
data item should be pointed to by the index item in question,
|
|
|
|
$cmp_data_func will be used. If $cmp_data_func returns a
|
|
|
|
non-negative value, the previous index item data will be
|
|
|
|
replaced by the given $item pointer. If the previous data need
|
|
|
|
to be freed, it should be done by the $cmp_data_func function,
|
|
|
|
because all references to it will be lost. If this function is
|
|
|
|
not provided ($NULL is given), index items will be
|
|
|
|
duplicated, if $cmp_func returns $0.]]
|
2014-03-23 04:49:26 -07:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
implements {
|
2014-06-20 02:47:39 -07:00
|
|
|
class.constructor;
|
2016-08-10 07:23:04 -07:00
|
|
|
Efl.Object.constructor;
|
2015-04-22 04:33:10 -07:00
|
|
|
Elm.Widget.theme_apply;
|
2017-08-23 23:31:05 -07:00
|
|
|
Elm.Widget.on_access_update;
|
2017-08-09 20:19:34 -07:00
|
|
|
Efl.Ui.Direction.direction { get; set; [[Only supports $vertical and $horizontal. Default is $vertical.]] }
|
2016-12-27 10:15:41 -08:00
|
|
|
Elm.Interface.Atspi_Accessible.children { get; }
|
2014-03-23 04:49:26 -07:00
|
|
|
}
|
|
|
|
events {
|
2016-11-23 02:46:01 -08:00
|
|
|
changed; [[Called when index changed]]
|
|
|
|
delay,changed; [[Called when delay changed]]
|
|
|
|
level,up; [[Called when level increased]]
|
|
|
|
level,down; [[Called when level decreased]]
|
2014-03-23 04:49:26 -07:00
|
|
|
}
|
|
|
|
}
|