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. Add a circle genlist 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

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 example sets the scrollbar visibility policy of a given scroller. This applies to the horizontal and vertical scrollbars respectively.

The following enumerator values are available for circle genlist:

  • ELM_SCROLLER_POLICY_AUTO

    The scrollbar is made visible if it is needed, and otherwise is kept hidden.

  • ELM_SCROLLER_POLICY_ON

    The scrollbar is on all the time.

  • ELM_SCROLLER_POLICY_OFF

    The scrollbar is off.

Activating a Rotary Event

To activate and deactivate the circle genlist, use the eext_rotary_object_event_activated_set() function. If the second parameter is EINA_TRUE, the circle genlist can 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 functions:

  • 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()

Circle genlist has the following items:

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

You can change the item properties by using the eext_circle_object_item_XXX() functions.

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

Go to top