In/Out Date

This control allows to enter a date.

In addition the trigger "valuechanged" will be fired.

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 object display to current date
webMI.trigger.fire("setValue", Date.now(), "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

  • format – The order of the input fields will either be "dd.mm.yyyy." or "mm.dd.yyyy" (default: dd.mm.yyyy)

  • interval [ms] (0 = off) – Specifies how long (time span) the control must be pressed to automatically change the base's value (default: 150ms, which means that in case the button keeps pressed, every 150ms the date will be changed)

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:

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

  • Advanced value field fill color inactive – Fill color of the value fields when not active (default: global parameter atvInactiveColor)

  • Standard fill color text – Background color of the text (value) (default: #d0d0d0)

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

  • Standard fill color arrow – Arrow's fill color (default: #d0d0d0)

  • Standard fill color arrow pressed – Arrow's fill color when they are pressed (default: #fdff0f)

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

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

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

Options:

  • minimum – Specifies the lower limit for the date (e.g. 1.1.2011) to be changed, i.e. if the current date equals to this minimum, the current date will not be further decremented (default: no minimum specified)

  • maximum – Specifies the upper limit for the date (e.g. 31.12.2011) to be changed, i.e. if the current date equals to this maximum, the current date will not be further incremented (default: no maximum specified)

  • address to set – With this parameter a second address can be set additionally in parallel to "base"

  • 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 control, i.e. to press one of the six 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.

  • show access control notification – Defines if the icon for showing access control notifications shall be displayed (default: true)

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.