Calendar
The control Calendar is used to display and manage exceptions to a schedule and select a date.
Use
Use on any page where a date is to be selected.
If a Schedule object is passed to the BaObject attribute in the EventCalendar display mode, the exceptions of a time schedule can also be displayed or edited.
Features
Provides two different display modes, the ability to manage exceptions and a color highlighting of related exceptions when the mouse pointer is over them.
DatePicker
A space-saving view of a calendar. Returns the selected date via an event.
EventCalendar
The EventCalendar is available in the month view and in the year view.
Month view
An event-oriented view of a calendar. It returns the selected date via an event and offers the option to manage an exception by clicking on it.
Year view
An overview of all days of the year with marking of the days on which at least one exception is active. Selecting a month changes to the month view.
Menu
In the upper right corner there are buttons for quick access and other actions.
Quick access:
- Today: Jumps to the current date.
- View: Switches between the month and year view.
Other actions:
- Show/Hide: Shows or hides exceptions.
- Add: Adds local exceptions.
- Save: Writes all changes to the PLC.
- Reset: Discards all unconfirmed changes.
Local exceptions
Entries in the aException collection of a Schedule object (e.g. FB_BA_SchedM) are regarded as local exceptions.
In the upper area, you can set the date or the repetition type of the local exception. Below this, the time periods with the applicable values can be set.
The automatic numbering of the local exceptions starts at 1.
Global exceptions (calendar reference)
Entries in the aCalendar collection of a Schedule object (e.g. FB_BA_SchedM) are regarded as global exceptions.
For global exceptions, only the time periods and applicable values can be defined. The date or the repetition type must be configured in the referenced Calendar object (e.g. FB_BA_Cal).
The automatic numbering of the global exceptions starts at 100.
Attributes
The control inherits from BaseControl and thus has the same attributes. In addition, there are the following attributes.
BA
BaObject
tchmi:framework#/definitions/Symbol
To use the generic functionalities of TcHmiBa. It links a single object or a complete view (including children) to the control.
 | You can find more detailed information about the generic possibilities of TcHmiBa under Generic HMI. |
Common
DisplayMode
Determines the display mode of the calendar.
DisplayView
Determines the view of the calendar in the EventCalendar display mode.
ShowMenu
Sets the visibility of the menu.
Events
Event | Description |
|---|---|
onDateChanged | Returns the selected date. |