Picker Date

This control opens a dialog to enter a date/time combination.

In addition the trigger "valuechanged" will be fired.

An additional border indicates the current value's negative state or an additionally defined alarm. The colors and blinking intervals are defined in global lists.

Triggers

Following triggers can be used for this object display:

  • com.atvise.setActive – Can be used to enable or disable the object display.

  • setValue – The object display connects to this trigger. Therefore, it is possible to set the value from the outside.

  • valuechanged – Fired on value changes, e.g. by user input.

//Disable the object display
webMI.trigger.fire("com.atvise.setActive", false, "myDisplayID");

//Set value of object display
webMI.trigger.fire("setValue", new Date().getTime(), "myDisplayID");

//Respond to value changes
webMI.trigger.connect("valuechanged", function(e) { console.log(e.value); }, "myDisplayID");

Hint

Additional undocumented triggers are internally used by atvise. Their functionality may be changed in future atvise releases.

Parameters

This control has the following generic parameters:

  • base – The value of this address will be set to the selected date

  • alarm address – Optional additional address of an alarm to be shown.

  • enable status monitoring – Switch monitoring of current value status on or off. (default: Yes)

  • fire status trigger – Instead of the status display a here defined trigger can be fired globally.

  • name – If more than one picker_date is used on the same display, a unique identifier has to be specified here

  • date picker dialog – Opens the date picker dialog (default: date picker dialog object display)

Font:

  • family – Font family which will be applied to value (default: Arial)

  • size – Font size which will be applied to the value (default: 12)

  • color – Color which will be applied to the value (default: global parameter atvFontColor (advanced), #000000 (standard))

Appearance:

  • fill color – Fill color of background areas (default: global parameter atvFillColor (advanced), #d0d0d0 (standard))

  • Advanced value field fill color – Fill color of the value field (default: #ffffff)

  • Advanced value field fill color inactive – Fill color of the value field when not active (default: #b7b7b7)

  • Standard fill color when inactive – Button's fill color if not active (default: #8c8c8c)

  • Standard button fill color – Fill color of the two buttons (default: #000000)

  • Advanced symbol color – Symbol's fill color (default: global parameter atvSymbolColor)

  • button stroke color pressed – The color of the stroke which will be set when one of the two buttons is pressed (default: #ffffff)

  • focus stroke color – The color of the stroke which will be set when the button is focused (default: #ffffff)

  • Advanced border color – Color of the border around the control (default: global parameter atvBorderColor)

  • status indication – Specify the status' display through a defined global list (default: global parameter atvStatusIndication)

  • alarm indication – Specify the alarm's display through a defined global list (default: global parameter atvAlarmIndication)

  • open picker centered – Open the picker dialog centered on the working screen or attached to the calling object display. (default: true)

Options:

  • show time – If set to "No" only the date without the time is shown (default: Yes)

  • consistency group – Name of the consistency group

  • tab index – Defines the order for changing between the object displays by using the tab key

  • tooltip – Displays a tooltip box with the entered text (standard HTML-Elements can be entered)

Security:

  • necessary right – The user must have this right to activate this button, i.e. to press one of the two buttons

  • activation address – If the value of this address equals to "activation value", then the control will be active, i.e. can be pressed

  • activation value – Value which activates the control

    Hint

    The activation of the control can be configured only by the necessary right, or only by the activation address and value or by both. In case both settings are made, the user must have the necessary right and the value of the "activation address" must equal the "activation value"; otherwise the control will not be activated.

Menu:

  • menu positioning – The position the menu symbol is shown at (top-left, top-right, bottom-left, bottom-right).

  • menu mouseover active – Symbol is only shown on mouseover.

  • menu symbol offset x – Relative offset of the menu symbol to the anchor point on the x axis in pixel.

  • menu symbol offset y – Relative offset of the menu symbol to the anchor point on the y axis in pixel.

  • context menu click frame – Defines the size of the click frame for opening the context menu.