DdsCharField.DefaultValue Property

Sets a default value to display in a CharField with the Usage property set to InputOnly.

Syntax

BegProp DefaultValue Access(*Public) Type(*String)
   BegGet;  BegSet

Property Values

String. The default value to display in the fields marked InputOnly.

Remarks

To set this property at design time, click on the right side of the property window and enter the default value for the field.

The value specified in this property will be used as the value of the field if the Field's Usage property is InputOnly. If the Usage value is OutputOnly or Both, the selected DefaultValue will be shown ONLY the first time the field is displayed while the associated program is running(any programmatically generated content will be ignored). If the field's value is updated while the program is running, the updated value will be shown instead.

The following variation applies when the DdsCharField.InputStyle property is Checkbox.

This DefaultValue property is used on character fields that are displayed as Checkboxes to determine if the checkbox should be marked as checked or not. On output operations, the value of the field determines the state of the checkbox as follows:

  • If the field value is equal to CheckedValue the box is checked; if the field value is equal to the UncheckedValue then the box is unchecked.
  • However if the field value is neither equal to CheckedValue or UncheckedValue, then the box will be checked if the CheckedValue is equal to the DefaultValue; basically, DefaultValue determines the default checkbox state for those fields with values outside of their domain.
  • In any event, when the Checkbox is displayed as checked, the value of CheckedValue will be returned to the program, and when the Checkbox is NOT checked, the value of UnCheckedValue will be returned to the program. In the process of returning the UnCheckedValue, if this value differs from the value output from the program, then the ChangeInd indicator will be set to TRUE for the field and for the Record ( DdsDataField.ChangeInd and DdsRecord.ChangeInd respectively).

Requirements

Namespace: ASNA.Monarch.WebDspF

Assembly: ASNA.Monarch.WebDspF.DLL

Platforms: Windows Server 2012, Windows Server 2012 R2, Windows Server 2016, Windows 7, Windows 8 Pro, Windows 10 Pro