## IupCalendar (since 3.17)

Creates a month calendar interface element, where the user can select a date.

GTK and Windows only. NOT available in Motif.

### Creation

    Ihandle* IupCalendar(void); [in C]
    iup.calendar{} -> (ih: ihandle) [in Lua]
    calendar() [in LED]

Returns: the identifier of the created element, or NULL if an error occurs.

### Attributes

TODAY (read-only): Returns the date corresponding to today in VALUE format.

VALUE: the current date always in the format "year/month/day" ("%d/%d/%d" in C). Can be set to "TODAY". Default value is the today date.

WEEKNUMBERS: Shows the number of the week along the year. Default: NO.

### Callbacks

VALUECHANGED_CB: Called after the value was interactively changed by the user.

    int function(Ihandle *ih); [in C]
    ih:valuechanged_cb() -> (ret: number) [in Lua]

ih: identifier of the element that activated the event.

MAP_CB, UNMAP_CB, DESTROY_CB, GETFOCUS_CB, KILLFOCUS_CB, ENTERWINDOW_CB, LEAVEWINDOW_CB, K_ANY, HELP_CB: All common callbacks are supported.

### Notes

In Windows, the view is changed when the month of year is clicked, so the user can select the month of the year or an year among years.

In GTK the today date is not marked in the calendar.

In GTK uses GtkCalendar, and in Windows uses MONTHCAL_CLASS.

### Examples

Windows Classic | Windows w/ Styles | GTK
--- | --- | ---

Browse for Example Files

### See Also

IupDatePick.