Tizen Native API  6.5

calendar_inheritance_tree.png

This is a calendar widget. It helps applications to flexibly display a calendar with day of the week, date, year and month. Applications are able to set specific dates to be reported back, when selected, in the smart callbacks of the calendar widget. The API of this widget lets the applications perform other functions, like:

  • placing marks on specific dates
  • setting the bounds for the calendar (minimum and maximum years)
  • setting the day names of the week (e.g. "Thu" or "Thursday")
  • setting the year and month format.

This widget inherits from the Layout one, so that all the functions acting on it also work for calendar objects.

This widget emits the following signals, besides the ones sent from Layout :

  • "changed" - emitted when the date in the calendar is changed.
  • "display,changed" - emitted when the current month displayed in the calendar is changed.
  • "focused" - When the calendar has received focus. (since 1.8)
  • "unfocused" - When the calendar has lost focus. (since 1.8)
  • "language,changed" - the program's language changed (since 1.9)

Supported elm_object common APIs.

Here is some sample code using it:

Functions

Evas_Objectelm_calendar_add (Evas_Object *parent)

Typedefs

typedef char *(* Elm_Calendar_Format_Cb )(struct tm *stime)

Typedef Documentation

typedef char*(* Elm_Calendar_Format_Cb)(struct tm *stime)

This callback type is used to format the string that will be used to display month and year.

Parameters:
stimeStruct representing time.
Returns:
String representing time that will be set to calendar's text.
See also:
elm_calendar_format_function_set()

Function Documentation

Add a new calendar widget to the given parent Elementary (container) object.

Parameters:
parentThe parent object.
Returns:
a new calendar widget handle or NULL, on errors.

This function inserts a new calendar widget on the canvas.

Calendar - Simple creation.

Since :
2.4
Examples:
calendar_example_01.c, calendar_example_02.c, calendar_example_03.c, calendar_example_04.c, calendar_example_05.c, and calendar_example_06.c.