Check

The check UI component accepts user input by the method of toggling. It is similar to the radio component, except that it does not work as a group. For more information, see the Check API.

This feature is supported in wearable applications only.

Basic Usage

To use a check component in your application:

1. Add a check component with the elm_check_add() function:

   Evas_Object *check;
   
   check = elm_check_add(parent);
   

2. Set a style and fill the check component with a text or an image according to the style:

   • Set a style to the check component with the elm_object_style_set() function. If you use the default style, you can skip this step.

     elm_object_style_set(check, "popup");
     

   • Set a label to the check component with the elm_object_text_set() function:

     /* Default style */
     elm_object_text_set(check, "Check");
     

3. Register the callback functions.

   The following example shows how to define and register a callback for the changed signal:

   evas_object_smart_callback_add(check, "changed", changed_cb, data);
   
   void
   changed_cb(void *data, Evas_Object *obj, void *event_info)
   {
       dlog_print(DLOG_INFO, LOG_TAG, "The value has changed\n");
   }
   

The following example shows a simple use case of the check component.

Example: Check use case

Evas_Object *win;
Evas_Object *conf;
Evas_Object *nf;
Evas_Object *box;
Evas_Object *check;

/* Starting right after the basic EFL UI layout code */
/* win - conformant - naviframe */

/* Add a box to pack a check */
box = elm_box_add(nf);
evas_object_show(box);
elm_naviframe_item_push(nf, "Check", NULL, NULL, box, NULL);

check = elm_check_add(box);

elm_object_style_set(check, "default");
evas_object_show(check);
elm_box_pack_end(box, check);

check = elm_check_add(box);
elm_object_style_set(check, "on&off");
evas_object_show(check);
elm_box_pack_end(box, check);

Styles

The following table lists the available component styles.

Table: Check styles for rectangular devices

Style	Sample	Text part
default		N/A
on&off		N/A
popup		default

Table: Check styles for circular devices

Style	Sample	Text part
default		N/A
on&off		N/A
small popup		default

Callbacks

You can register callback functions connected to the following signals for a check object.

Table: Check callback signals

Note

The signal list in the API reference can be more extensive, but only the above signals are actually supported in Tizen.

Note

Except as noted, this content is licensed under LGPLv2.1+.

Related Information

• Dependencies
  • Tizen 2.3.1 and Higher for Wearable