<< Click to Display Table of Contents >> Navigation: Object Reference > Palette Objects > String Field |
The string field object is designed to show text on the screen. It can be customized like any other object using it's properties.
The string field has a lot of common properties. See here for a description of them. Here only the string field specific properties are described.
Besides the Auto Wrap property, Texts in String Fields can also have custom line breaks by inserting "\n" (without the "") in the text.
The line break can also be included at runtime via JavaScript by adding \n in a String variable and having that referenced to the String Field or, alternatively by putting the text into the String Field with setProperty.
Please note that for existing projects in the rare case the text "\n" should be used in a String Field, this will now be interpreted as a line break.
In that case, please change "\n" to e.g. "\ n" to avoid the line break.
Auto WrapWhen Auto Wrap is enabled, the text inside the string field will be automatically wrapped to the next line if the text does not fit inside the string field. If possible, wrapping will leave the words in the text complete. If the string field is to narrow to display even a single word, the single word will be splited. If Auto Wrap is disabled, text that does not fit in the string field will be clipped. Default value: Disabled Possible values: Disabled or Enabled Max String Length (Characters)The maximum length of the text displayed in the string field can be adjusted with this property. Note that the value of a referenced variable or the Preview Value of the string field may have more characters but they are just not displayed if it's more than Max String Length. Default value: 32 Possible values: 0 ... 65536 |
The following events can be configured for the string field object: •OnOpenForInput •OnEnabledWithFocus •OnEnabledWithoutFocus •OnValueChange •OnEnterValue •OnEnterNewValue •OnEscape See here for the descriptions of all event and possible actions that can be assigned. |