setTextFromInteger64

The setTextFromInteger64 method sets the text from the textUser property of a JadeEditMask control to an Integer64 value converted to a String in the format of the locale under which the control is running (for details, see the languageId property). Note that an exception is raised if the resulting string does not conform to the data format specified by the mask property value.

The setTextFromInteger64 method of a TextBox control sets the text property value to an Integer64 value converted to a String in the format of the locale of the user application. Note that an exception is raised if the resulting string exceeds the maxLength property value of the text box.

When the EnhancedLocaleSupport parameter in the [JadeEnvironment] section of the JADE initialization file on the database node is set to true, the JadeEditMask class validates the setting and entry of text based on the mask property, using the current locale of the client with regional overrides on both the presentation client and the application server.

When the EnhancedLocaleSupport parameter is not defined or it is set to false, inconsistent results could be returned to the application server when running in JADE thin client mode and there are regional overrides, as all overrides on the application server are suppressed. By default, formatting of locale data is done on the application server, based on the locale of the corresponding presentation client.

A numeric JadeEditMask control expects the negative sign, decimal place, and separator characters to be in the form defined for the locale under which the control is running. A numeric TextBox control expects the negative sign and decimal place characters to be in the form defined for the locale under which the user is running. This applies when accessing the text or textUser properties and when the user enters data. Setting the text by using the setTextFromInteger64 method converts the numeric into the appropriate String for that locale. Retrieving the Integer64 value by using the getTextAsInteger64 method does the reverse. You can therefore use the getTextAsInteger64 and setTextFromInteger64 methods to access numeric text so that JADE handles the locale format for you.

The position of a negative sign indicated by the locale is honored by a leading or trailing numeric in the JadeEditMask or TextBox control. However, locales that specify a negative value expressed by parentheses (for example, (123)) are treated as a leading dash symbol (-). In addition, locales that have a leading or trailing space associated with a negative sign are treated as the equivalent format without the space (for example, - 123 will be ‑123 and 123 - will be 123-).