maxLength

maxLength specifies maximum length in bytes for strings input to a field.

 

Inside the following text widgets: TextField, TextArea, FunctionField can be enabled maxlength tracker that shows number of the characters left inside the widget field. To enable the maxlength tracker, specify the maximum length for strings inside the maxLength field:

 

maxLength tracker applied for the FunctionField

maxLength tracker applied for the TextArea

maxLength tracker applied for TextField. (Example shows TextField field with hidden symbols):

Form XML code:

Possible values:

any integer (limited by the data type (and size) of a variable assigned to the field)

Default value:

depends of the data type (and size) of a variable assigned to the field

Associated containers, widgets and theme elements:

Browser Calendar ComboBox FunctionField

TextArea TextField TimeEditField

Associated 4gl syntax:

INPUT

INPUT ARRAY

Associated ui methods:

SetMaxLength ↓

GetMaxLength ↓

Influence and behavior:

The value set to the property specifies the maximum length (in bytes) you will be able to input into the field:

For the first textArea (identifier=f1), maxLength=5.

For the second textArea (identifier=f2), maxLength=10.

4gl code sample:

intended input:

1234567890

runtime appearance:

When set together with autonext, the property can be used in order to increase the interface user-friendliness.

 

At runtime, you can use ui methods to find out the maximum length of the data string which can be input to the field and change it:

LET widget_var= ui.<widget>.ForName("widget_id1")

CALL widget_var.setMaxLength(<int>)

4gl code sample:

initial runtime appearance:

runtime appearance after ui methods were applied:

 

LET widget_var = ui.<widget>.ForName("widget_id1")

DISPLAY widget_var.getMaxLength()

4gl code sample:

runtime appearance: