Circle Spinner

This feature is supported in wearable applications only.

The circle spinner component extends the spinner component (elm_spinner) by visualizing its value. The circle spinner increases or decreases the value of the elm_spinner through a clockwise or counter-clockwise rotary event.

Figure: Circle spinner component

Circle spinner component

Adding a Circle Spinner Component

To create a circle spinner component:

  1. Create an elm_spinner object:

    Evas_Object *spinner;
    Evas_Object *circle_spinner;
    
    spinner = elm_spinner_add(parent);
    
  2. Set the object style as circle:
    elm_object_style_set(spinner, "circle");
    
  3. Create an eext_spinner object using the eext_circle_object_spinner_add() function.
    Pass a circle surface as the second parameter.

    circle_spinner = eext_circle_object_spinner_add(spinner, surface);
    

The circle spinner component is created with the default style.

Configuring the Circle Spinner

To handle the circle spinner value, use the elm_spinner functions. They are automatically synchronized with the user values. You can also use the elm_spinner callback functions.

Activating a Rotary Event

To activate or deactivate the circle spinner, use the eext_rotary_object_event_activated_set() function:

eext_rotary_object_event_activated_set(circle_spinner, EINA_TRUE);

If the second parameter is EINA_TRUE, the circle spinner can receive rotary events.

Configuring the Circle Properties

To configure the circle properties of the circle spinner:

  • You can disable the circle object within the circle spinner component using the following functions:

    • eext_circle_object_disabled_set()
    • eext_circle_object_disabled_get()