Wearable native

Circle Genlist

This feature is supported in wearable applications only.

Use the circle genlist to visualize and utilize the scroll effect for elm_genlist. While elm_genlist provides a scrollbar with straight horizontal and vertical movement, the circle genlist provides scrollbar with circular movement. It is also operated with rotary events to move to the next or previous item.

Figure: Circle Genlist

Circle Genlist

Creating a Circle Genlist

A genlist and a surface are necessary when creating the circle genlist. The circle genlist is added with the eext_circle_object_genlist_add() function.

Evas_Object *genlist, *circle_genlist, *parent;

genlist = elm_genlist_add(parent);
circle_genlist = eext_circle_object_genlist_add(genlist, surface);

Configuring the Circle Genlist

You can set the circle genlist scroller policy by using the eext_circle_object_genlist_scroller_policy_set() function.

eext_circle_object_genlist_scroller_policy_set(circle_genlist, 
                                               ELM_SCROLLER_POLICY_OFF, 
                                               ELM_SCROLLER_POLICY_ON);

This sets the scrollbar visibility policy of a given scroller. ELM_SCROLLER_POLICY_AUTO indicates the scrollbar is made visible if it is needed, and otherwise is kept hidden. ELM_SCROLLER_POLICY_ON turns the scrollbar on all the time, and ELM_SCROLLER_POLICY_OFF turns it off. This applies to the horizontal and vertical scrollbars respectively.

The following enum values are available for circle genlist.

  • ELM_SCROLLER_POLICY_AUTO
  • ELM_SCROLLER_POLICY_ON
  • ELM_SCROLLER_POLICY_OFF

Activating a Rotary Event

You can activate and deactivate the circle genlist by using the eext_rotary_object_event_activated_set() function. If the second parameter is EINA_TRUE, the circle genlist can receive the rotary event. Otherwise, the circle genlist cannot receive the rotary event.

eext_rotary_object_event_activated_set(circle_genlist, EINA_TRUE);

Using the Circle Object Property

Circle genlist objects support the following circle object API calls:

  • eext_circle_object_line_width_set()
  • eext_circle_object_line_width_get()
  • eext_circle_object_radius_set()
  • eext_circle_object_radius_get()
  • eext_circle_object_color_set()
  • eext_circle_object_color_get()
  • eext_circle_object_disabled_set()
  • eext_circle_object_disabled_get()

A circle genlist has the following item:

  • default: Default circle item. It draws vertical scroll bar.
  • vertical,scroll,bg: Vertical scroll background circle item.

You can change the properties of the items by using the eext_circle_object_item* APIs.

For more information, see the Efl Extension Circle Genlist API.

Go to top