DateTimeInput

<< 点击显示目录 >>

主页  mappView帮助助手 > mapp View帮助信息 > Widgets  > DateTime  >

DateTimeInput

Widget "DateTimeInput" makes it possible to enter dates and times.

The following properties cannot be used in compound widget "Mapping":

zIndex, left, top, height, width

Appearance

datetimeinput_editor

datetimeinput_runtime

Editor

Web browser

Properties

Name

Type

Description

Bindable

Necessary

Default value

enable

Boolean

Defines the usability of the widget. A disabled widget (enable=false) does not react to user interaction and does not trigger events. The "enable" behavior is inherited from the container widgets to the child widgets.

check

 

true

format

DateFormat

Defines the format used to display the date and/or time.

It is possible to specify a format string (e.g. "HH:mm:ss") or predefined pattern (e.g. "F").

check

 

F

permissionOperate

RoleCollection

Defines the roles that are permitted to use the widget. For roles without sufficient rights, the widget does not react to user interaction and does not trigger events.

 

 

 

permissionView

RoleCollection

Defines the roles that are permitted to see the widget. For roles without sufficient rights, the widget is hidden.

 

 

 

pickerPosition

Position

Defines the position of "DateTimePicker" used to enter data. Possible values:

bottom, center, top, left, middle, right

 

 

right

style

StyleReference

Reference to a customizable widget style.

check

 

default

submitOnChange

Boolean

Defines whether changes, such as entry of a different value, should be submitted to the server immediately. Submit immediately = true.

The change only takes place if "DateTimePicker" is closed using button "Enter".

 

 

true

value

DateTime

Defines the value of the widget (i.e. the date/time specification to be displayed).

For value, a default value should always be set in the ECMA standard, e.g. 2017-02-11T05:11:03.000Z. Even if a binding exists, the default value must be set!

check

 

1970-01-01T00:00:00.000Z

visible

Boolean

Defines the visibility of the widget. The widget can be hidden with visible=false. (visible = true, hidden = false). The "visible" behavior is inherited from the container widget to the child widgets.

check

 

true

zIndex

UInteger

zIndex determines the z-order of the widget. With overlapping widgets, the zIndex determines which widget is on the top and which one is on the bottom. The widget with the larger zIndex is on top, and the one with the smaller zIndex is on the bottom. The zIndex must be unique within a piece of content or a container widget. The zIndex is automatically assigned by the visual editor and can therefore be changed via the toolbar.

 

check

 

left

Integer

Absolute position measured from the left border of the surrounded element (e.g. container widget or content).

 

 

 

top

Integer

Absolute position measured from the top border of the surrounded element (e.g. container widget or content).

 

 

 

height

Size

Defines the total height of the widget in pixels.

A value in % refers to the height of the surrounding element.

 

 

30

width

Size

Defines the total width of the widget in pixels.

A value in % refers to the width of the surrounding element.

 

 

250

tooltip

String

Defines the text that should appear as information when the tooltip indicator is pressed.

You can use a static text or a text from the text system. For more information, see here.

Mode "Tooltip" must be enabled for this. There are two different options for this:

Using action "ShowTooltip"

Using action "Client system" ShowTooltips.

 

 

 

draggable

Boolean

Defines whether the widget can be dragged at runtime. This can be used to perform actions or establish relationships between two widgets.

If true, the widget can be moved onto another widget. The source widget remains in its position and a copy is created and dragged. Actions OnDragStart and OnDragEnd can be used.

If false, the widget cannot be moved.

For more information, see here.

 

 

false

tabIndex

Integer

Property tabIndex is used to manage the tab order during keyboard operation.

For additional information, see Keyboard operation.

ENTER triggers event Click if tabIndex ≥0.

It is not possible to enter a date or time with the keyboard.

 

 

-1

Styleable properties

Name

Type

Description

Default value

borderWidth

PixelValCollection

Defines the width of the border around the widget.

2px 6px 2px 2px

cornerRadius

PixelValCollection

Defines the corner style of the widget.

0px

backColor

Color

Defines the background color of the widget.

#FFFFFF

backGroundGradient

Gradient

Defines the background color of the widget as a color gradient.

 

borderColor

ColorCollection

Defines the color of the border around the widget.

#555555

activeBorderColor

ColorCollection

Defines the color of the border around the widget during operation.

#FF8800

activeBorderWidth

PixelValCollection

Defines the width of border around the widget during active operation.

2px 6px 2px 2px

activeBackColor

Color

Defines the background color of a widget during operation.

#F1F1F1

activeTextColor

Color

Defines the color used to display the text during operation.

#000000

borderStyle

BorderStyle

Defines the style of the border around the widget. Borders can be unbroken, dashed or dotted.

solid

textColor

Color

Defines the color used to display the text.

#000000

textAlign

TextAlign

Defines the orientation of the text.

right

opacity

Opacity

Defines the transparency of the widget. The lower the value, the more transparent the widget.

1

fontName

FontName

Defines the font used for the text shown.

Arial

fontSize

PixelVal

Defines the size of the font used to display the text.

16px

rotation

Rotation

Defines the rotation of the widget, e.g. a value of 90 degrees changes the rotation of the widget by 90 degrees clockwise.

0deg

bold

Boolean

Defines whether the text is shown in bold.

true

italic

Boolean

Defines whether the text is shown in italics.

false

padding

Padding

Defines the spacing between the outer boundary of the widget and its content. For more information, see here.

0 15px 0 15px

margin

Margin

Defines the offset of the external boundary of the widget to the widget's actual set position. For more information, see here.

0px

shadow

Shadow

Defines the shadow of the widget.

none

disabledBackColor

Color

Defines the background color of the widget in the disabled state.

#F1F1F1

disabledBackGroundGradient

Gradient

Defines the background color of the widget as a color gradient in the disabled state.

 

disabledBorderColor

ColorCollection

Defines the color of the border around the widget in the disabled state.

#C8C8C8

disabledBorderWidth

PixelValCollection

Defines the width of the border around the widget in the disabled state.

2px 6px 2px 2px

disabledTextColor

Color

Defines the color of the text in the disabled state.

#C8C8C8

Topics in this section:

Actions and events