+ <docstring>The calendar control allows the user to pick a date interactively.</docstring>
+ <refdoc>The CalendarCtrl displays a window containing several parts: the control to
+pick the month and the year at the top (either or both of them may be
+disabled) and a month area below them which shows all the days in the
+month. The user can move the current selection using the keyboard and select
+the date (generating EVT_CALENDAR event) by pressing <Return> or double
+clicking it.
+
+It has advanced possibilities for the customization of its display. All global
+settings (such as colours and fonts used) can, of course, be changed. But
+also, the display style for each day in the month can be set independently
+using CalendarDateAttr class.
+
+An item without custom attributes is drawn with the default colours and font
+and without border, but setting custom attributes with SetAttr allows to
+modify its appearance. Just create a custom attribute object and set it for
+the day you want to be displayed specially A day may be marked as being a
+holiday, (even if it is not recognized as one by wx.DateTime) by using the
+SetHoliday method.
+
+As the attributes are specified for each day, they may change when the month
+is changed, so you will often want to update them in an EVT_CALENDAR_MONTH
+event handler.
+
+ Styles
+ CAL_SUNDAY_FIRST: Show Sunday as the first day in the week
+ CAL_MONDAY_FIRST: Show Monday as the first day in the week
+ CAL_SHOW_HOLIDAYS: Highlight holidays in the calendar
+ CAL_NO_YEAR_CHANGE: Disable the year changing
+ CAL_NO_MONTH_CHANGE: Disable the month (and, implicitly, the year) changing
+ CAL_SHOW_SURROUNDING_WEEKS: Show the neighbouring weeks in the previous and next months
+ CAL_SEQUENTIAL_MONTH_SELECTION: Use alternative, more compact, style for the month and year selection controls.
+
+The default calendar style is wxCAL_SHOW_HOLIDAYS.
+
+ Events
+ EVT_CALENDAR: A day was double clicked in the calendar.
+ EVT_CALENDAR_SEL_CHANGED: The selected date changed.
+ EVT_CALENDAR_DAY: The selected day changed.
+ EVT_CALENDAR_MONTH: The selected month changed.
+ EVT_CALENDAR_YEAR: The selected year changed.
+ EVT_CALENDAR_WEEKDAY_CLICKED: User clicked on the week day header
+
+Note that changing the selected date will result in either of
+EVT_CALENDAR_DAY, MONTH or YEAR events and an EVT_CALENDAR_SEL_CHANGED event.
+
+</refdoc>
projects / wxWidgets.git / blobdiff