Although the value of the control is alphanumeric, usual practice is to treat the value as if it were numeric, setting and retrieving its value using numeric variables. The run-time system and the control perform any necessary conversions.
The control does not usually allow invalid date or time values. This can be circumvented with the SHOW-NONE style.
Date entry controls calculate width by multiplying the SIZE setting by the standard width of the font and then adding overhead for the box, 3-D effect, and calendar drop-down button. In most cases, you will get good results by setting the SIZE roughly equal to the number of characters in the formatted display. The default SIZE value is 8.
Note that a date entry control automatically makes small adjustments to its specified size and position in order to better align with other ACUCOBOL-GT controls that use the 3-D format
This property enables you to apply CSS styles to the control when the program is run through AcuToWeb. The value of ATW-CSS-CLASS should represent a corresponding class in the current theme ( cascading style sheet) deployed when you run your program through AcuToWeb. This property can be applied to more than one control in your program.
If both the ATW-CSS-CLASS and ATW-CSS-ID properties are specified for this control, and both correspond to the same style in the style sheet, the style specified by ATW-CSS-ID takes precedence.
See Cascading Style Sheet Syntax for more information about additional in-built styles in AcuToWeb.
This property enables you to apply CSS styles to the control when the program is run through AcuToWeb. The value of ATW-CSS-ID should represent a corresponding ID in the current theme (cascading style sheet) deployed when you run your program through AcuToWeb. The value of this property must be unique, and only applied to one control in your program.
If both the ATW-CSS-CLASS and ATW-CSS-ID properties are specified for this control, and both correspond to the same style in the style sheet, the style specified by ATW-CSS-ID takes precedence.
See Cascading Style Sheet Syntax for more information about additional in-built styles in AcuToWeb.
EVENT-LIST is an exclusive list of events that are either sent to or withheld (blocked) from the program depending on the value of EXCLUDE-EVENT-LIST. See Common Screen Options for more information.
| CENTURY-DATE | Uses nearly the same format as the SHORT-DATE style, but the year portion always appears as four digits, even if the user has specified a two-digit format in the Windows Control Panel. Users must have Internet Explorer 5.0 or later installed to use this style successfully. |
| LONG-DATE | Causes the date entry control to display a localized long date format. The exact format of the long date depends on settings specified by the user in the Windows Control Panel. In the United States, a common long date format is Monday, February 16, 2004. |
| NO-F4 | By default, the date entry control lets users open the calendar using the F4 key. This style prevents the control from using this shortcut, reserving this key for your program's use. Note that the Alt+Down Arrow key combination also opens the calendar. |
| NO-UPDOWN | By default, the date entry control lets users scroll through the valid values for each portion of the date or time using the up and down arrow keys. This style disables these functions, reserving the arrow keys for your program's use. Note that users can still scroll through values in the date entry control using the + and - keys on the numeric keypad. |
| NOTIFY-CHANGE | Causes the date entry control to generate an NTF-CHANGED event each time the user changes the displayed date or time. If this style is not specified, the program is informed of a new value in the control only when the user leaves the field or performs a terminating event (like pressing a function key). |
| RIGHT-ALIGN | Causes the drop-down calendar to be roughly aligned with the right edge of the date entry control. By default, the calendar is aligned with the left edge of the control. |
| SHORT-DATE |
Causes the date entry control to display a localized short date format. The exact format of the short date depends on settings
specified by the user in the Windows
Control Panel. In the United States, a common short date format is
02/16/2004.
If no other format is specified, the control will default to the SHORT-DATE format. |
| SHOW-NONE |
Adds a check box to the date entry control. When the check box is checked, the control contains a valid date and/or time.
When the check box is not checked, the control behaves as if it had no value, returning all zeroes instead of a date, or all
nines instead of a time.
If you have created a date entry control with the SHOW-NONE style, you can programatically cause the check-box to be unchecked and the value to appear grayed out by setting a date of zero or a time of all nines. Likewise, by setting a valid date or time, you can cause the check-box to appear checked and the value to appear normally. To create a date entry control that uses the SHOW-NONE style and starts with no date or no time, for example, you could use one of the following statements: DISPLAY DATE-ENTRY, SHOW-NONE, VALUE ZERO DISPLAY DATE-ENTRY, SHOW-NONE, VALUE 999999 Note that the 999999 in the second example assumes the default HHMMSS time format. |
| SPINNER |
By default, a date entry control displays the date with a button used to open a drop-down calendar. When you specify this
style, that button is replaced with small up and down arrows that can be used to modify each portion of the date without referring
to the calendar.
The spinner arrows appear by default when the date entry control displays a time format. |
| TIME |
Causes the control to show a localized time format. The exact format depends on settings specified by the user in the Windows
Control Panel.
10:35 AM is a typical format.
If this style is set when the control is created, the VALUE-FORMAT property is given the default value DAVF-HHMMSS. See the description of the VALUE-FORMAT special property for more information. |