ComponentOne True DBInput Pro 8.0
ShowLiterals Property (TDBMask)

 

Reference> TDBMask Control> TDBMask Control Properties> ShowLiterals Property (TDBMask)

ShowLiterals Property (TDBMask)

The ShowLiterals property allows you to return or set whether the prompt character and any literals used in the input mask are shown at all times, or only displayed as the user enter data. This property takes effect only during input within the control.

Syntax

control.ShowLiterals= value

Read/Write at run time and design time.

Values

Design Time

Run Time

0 - Always (Default)

dbiShowLiteralsAlways

1 - Post Display

dbiShowLiteralsPostDisp

2 - Pre Display

dbiShowLiteralsPreDisp

Remarks

If set to 0 - Always, the complete data entry mask and all literals will be displayed at all times.

If set to 1 - Post Display, the literals will be inserted after the user enters the first character of the field that follows the literals. For example, with the input mask set to "yyyy.mm.dd", the user would need to input the first character of the month field in order to display the literal (".") following the year field. ( Ex. 1998.1| ) Simply entering 1998, will not display the literal. ( Ex. 1998| )

Unlike 1 - Post Display, if set to 2 - Pre Display, the literals that follow the input mask will be inserted after the user enters the last character in the current field. For example, with the input mask set to "yyyy.mm.dd", if the user enters 1998, as soon as the character 8 is pressed, the literal (".") will be automatically inserted and the caret will be placed on the right side of the literal, waiting for the month field to be entered ( Ex. 1998.| ).

In both the 1 - Post Display and the 2 - Pre Display cases, the literals will be removed as the user deletes the entered data. Also, the literals placed on both ends of the input mask will be displayed as soon as the user enters the first or the last character in the input mask.

This property will not have any effect when the control allows free format entry.

See Also

Format Property (TDBDate)

Format Property (TDBMask)

Format Property (TDBTime)

 

 


Copyright (c) GrapeCity, inc. All rights reserved.

Product Support Forum  |  Documentation Feedback