Please enable JavaScript to view this site.

DAQFactory User's Guide

Navigation: 7 Pages and Components > 7.18 The Components > 7.18.9 Selection

7.18.9.4 Time Select Component

Scroll Prev Top Next More

The time select component displays a clock to allow the user to select a time. It is identical to the clock that appears with the date/time edit component, but can also be made read only, and basically act as a clock display.  

Properties:

Main:

OutputTarget: the channel or variable name that is updated with the number of seconds since midnight for the selected time, so a number between 0 and 86399.

ReadOnly: if selected the component becomes readonly, so basically acts like a clock display.

Cap:

CapSize: size of the cap at the center of the analog clock.

CapFillBrush, CapFillBrushPreset: brush (color) used to draw the cap at the center of the analog clock.

CapBorderBrush, CapBorderBrushPreset: brush (color) used to draw the border of the cap at the center of the analog clock.

Format:

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.

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

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

AMText, PMText: the text you would like displayed for AM (midnight to noon) and PM (noon to midnight).  

Frame:

FrameSize: size of the outer frame of the analog clock.

GaugeBackBrush, GaugeBackBrushPreset: brush (color) used to draw the background of the analog clock (which is actually an angular gauge!)

FrameFillBrush, FrameFillBrushPreset: brush (color) used to fill the main part of the analog clock frame.

FrameFillInvBrush, FrameFillInvBrushPreset: brush (color) used to draw the inverted part of the analog clock frame.

FrameBorderBrush, FrameBorderBrushPreset: brush (color) used to draw the outline of the analog clock frame.

Pointer:

PointerFillBrush, PointerFillBrushPreset: brush (color) used to fill the hour and minute pointers.

PointerBorderBrush, PointerBorderBrushPreset: brush (color) used on the border of the hour and minute pointers.

OtherPointerOpacity: the opacity of the pointer not currently being used to set the time.

Ticks:

ScaleOffset: tick offset from the frame of the clock.

MajorTickStyle: style of the hour ticks of the clock.

MajorTickSize: size of the hour ticks of the clock.

MinorTickStyle: style of the minute ticks of the clock.

MinorTickSize: size of the minute ticks of the clock.

MinorTickLocation: position of the minute ticks compared to the hour ticks.

TickMarkFillBrush, TickMarkFillBrushPreset: brush (color) used to fill the tick marks.

TickMarkBorderBrush, TickMarkBorderBrushPreset: brush (color) used for the border of the tick marks.

ClockTextFormat, ClockTextFormatPreset: format (font, etc) of the text used for the analog time display.

ClockTextBrush, ClockTextBrushPreset: brush (color) used on the text of the analog time display.

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 time.  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 seconds since midnight.

Events:

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