The calendar component displays a calendar that the user can select a date from.  It is identical to the calendar that appears with the date/time edit component, but also allows multiple months to be displayed.

Properties:

Main:

OutputTarget: the channel or variable name that is updated with the DAQFactory time stamp for Midnight of the selected date.  DAQFactory time stamps are in seconds since 1970.

SingleMonth: if selected, only one month is displayed.  If unselected, the system will draw as many months as will fit in the component.

Format:

SelectionTextBrush, SelectionTextBrushPreset: brush (color) used to draw text of the selected date

SelectionBackBrush, SelectionBackBrushPreset: brush (color) used to draw the background for the selected date.

TextFormat, TextFormatPreset: the format (font, etc) of the text used in the component.

TextBrush, TextBrushPreset: the brush (color) used in the text of the component.

OtherMonthTextBrush, OtherMonthTextBrushPreset: brush (color) used to draw the numerical days in other months (if SingleMonth is not enabled).

CaptionTextBrush, CaptionTextBrushPreset: brush (color) used to draw the month caption.

CaptionBackBrush, CaptionBackBrushPreset: brush (color) used to draw the background of the month caption.

ArrowBrush, ArrowBrushPreset: brush (color) used to draw the arrows for switching months.

DOWTextBrush, DOWTextBrushPreset: brush (color) used to draw the days of the week captions.

LineBrush, LineBrushPreset: brush (color) used to draw the line separators.

TodayBrush, TodayBrushPreset: brush (color) used to draw the rectangle indicating today's date.

Common Properties:

This component includes all the common properties of components plus the background properties described in section 7.4.4.

Variables:

Contents: accessible from script.  Provides direct access to the currently displayed date.  This is a read / write variable so you can change the contents of the component directly from script, though that will not trigger the OnSelect event, nor update OutputTarget.  The value is a number in DAQFactory time, so seconds since 1970.

Events:

OnSelect: called when the operator has selected a date.  The variable Contents is passed to the event with the displayed date in units of DAQFactory time (seconds since 1970).  If you return() a non-zero value, the OutputTarget will not be updated with the new text.