Scheduler Widget Sample Overview

Wearable native

The Scheduler Widget sample application demonstrates how you can manage text objects and image objects to create a complete widget view.

For information on creating the sample application project in the IDE, see Creating Sample Applications.

The following figure illustrates the main screen of the Scheduler Widget.

Figure: Scheduler Widget screen

Scheduler Widget screen

The widget displays the tasks for a specific day.

Source Files

You can create and view the sample application project including the source files in the IDE.

Table: Source files
File name Description
edje/images This directory contains the image files used in the main.edc file.
inc/data.h This file contains information and definition of the variables and functions used in the C files, especially in the data.c file.
inc/log.h This file contains the log tag. It can also contain information and definition of the variables and functions used in the C files.
inc/view.h This file contains information and definition of the variables and functions used in the C files, especially in the view.c file.
res/edje/main.edc This file is for the UI and contains style, image, and position of the sample application.
res/images This directory contains the image files used in the C files.
src/data.c This file contains the functions for retrieving and making data for the application.
src/main.c This file contains the functions related to the application life-cycle, callback functions, and view control.
src/view.c This file contains the functions for implementing the views and handling events.

Implementation

Application Layout

The view_create() function creates the widget view frame that consists of the window, text parts, and image parts.

view_create(context, w, h);

Figure: Scheduler Widget view frame

Scheduler Widget view frame

To fill out the text parts:

  1. Implement the data_get_text() function to create the text you want to use. In this function, you can also choose the part name which you want to fill out.

  2. Call the view_set_text() function with the part name and text you obtained.

In this example, the text to use is txt_day and the part name to fill out is widget.day.

txt_day = data_get_text("widget.day");
view_set_text(wid, "widget.day", txt_day);

Setting Touch Events

The view_set_event_callback() function controls the widget main operation that launches an application from the home screen.

The launch options are:

  • WIDGET_EVENT_PRESSED for launch on a touch press event
  • WIDGET_EVENT_RELEASED for launch on a touch release event
  • WIDGET_EVENT_CLICKED for launch on a click event

In this example, the widget launches an application when the user clicks the widget:

view_set_event_callback(wid, "widget.event", WIDGET_EVENT_CLICKED, clicked_cb);