Properties of the ENTRY FIELD Object

Defines the adjustment of an object placed in the view of a split bar object, when the user drags the horizontal bar below the object, or when he/she resizes the window below and when the split bar expands (VERTICAL_ADJUSTMENT property equal to _SPLT_ADJUST_EXPAND_HEIGHT) and if the object belongs to one of the bottommost views.

Note: This property is not implemented in Java and Mobile generation.

Defines the adjustment of an object placed in the view of a split bar object, when the user drags the vertical bar to the left of the object, or when he/she resizes the window below and when the split bar expands (HORIZONTAL_ADJUSTMENT property equal to _SPLT_ADJUST_EXPAND_WIDTH) and if the object belongs to one of the rightmost views.

Note: This property is not implemented in Java and Mobile generation.

Defines the adjustment of an object placed in the view of a split bar object, when the user drags the vertical bar to the right of the object, or when he/she resizes the window below and when the split bar expands (HORIZONTAL_ADJUSTMENT property equal to _SPLT_ADJUST_EXPAND_WIDTH) and if the object belongs to one of the rightmost views.

Note: This property is not implemented in Java and Mobile generation.

Defines the adjustment of an object placed in the view of a split bar object, when the user drags the horizontal bar above the object, or when he/she resizes the window above and when the split bar expands (VERTICAL_ADJUSTMENT property equal to _SPLT_ADJUST_EXPAND_HEIGHT) and if the object belongs to one of the bottommost views.

Note: This property is not implemented in Java and Mobile generation.

Allows the object to be placed in focus.

Objects placed in focus are receptive to actions performed by the user using the keyboard and/or mouse.

Defines the alignment used when displaying text inside the object. In Windows 95, Windows NT 4.0 and earlier versions, the TEXT object is always left-aligned if the "Multiline" property is set to False, irrespective of the value of this property.

Note: In Mobile generation, this property is modifiable only if the object has the "Multiline" property.

RGB color in which the object's background is displayed when the object is active but not in read-only mode.

The property's value corresponds to a RGB color. Each color has a red, green and blue component in the range [0 ; 255]. The value of the resultant color is calculated as follows: Color = B*65536 + G*256 + R . Some values are predefined using the constants listed below.

Draws a sunken border around the object.

Specifies the format used to display the object's value.

Click here for more details on edit codes.

Defines the edit word used when displaying the object's value.

Click here for more details on edit words.

Expands the input field across the whole screen, so that its content is easier to read.

Note: This property is available only in Mobile generation mode for the Smartphone platform.

Character font used to display the text in the object.

The string format contains the name, size, style and script, in that order. A semi-colon must be inserted between each element.

If you set a property's value, you MUST specify the name and size.

The different styles are specified using the following values:

• • 1: Normal (no special style)
  • 2: Strikethrough
  • 16: Italics
  • 256: Bold
  • 4096: Underlined

The style value to be specified in the string can either be one of the above values or else the sum of values other than 1.

The different script values are as follows:

Notes:

The size, style and script must be compatible with the chosen font. The Windows system font selection dialog box, accessible via the graphical object's Properties pages, provides a guide for selecting coherent values.

The "Underlined" style is not considered by the Java generator.

Specifies the first object in a group of objects. A group of objects is defined by its first object and all the following objects (following the object sequence) until the first object in another group is reached. The user can use the arrow keys to change focus from one object to another within the same group.

Height value of the object.

Defines how the graphical control is adjusted when the window is resized horizontally.

Note: This property is not implemented in Java and Mobile generation.

Allows the use of a horizontal scroll bar for viewing the text in the object.

Defines the filter used when entering characters.

Input modes available on a mobile telephone.

In "per-character" input mode, the user can enter various letters via the same key, depending on the number of times in succession it is pressed.

In ambiguous mode, you only need to press a key once to enter a character; the system suggests a range of possible words based on an internal dictionary.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Allows text to be entered over more than one line.

Static name of the object.

Authorizes the object to draw itself over a control positioned in front of it in the window object order.

In the particular case where the window has a background image with transparent images placed in foreground, it is necessary to set the property to *TRUE if you wish to put the object after a "transparent" object in the tab order.

Reminder: an "overlapped" object must be placed after the background image, while a "non-overlapped" object must be placed before the background image.

For more information about managing overlapping of graphical objects, consult the working with object overlap section.

Note: This property is not implemented by the Java and Mobile generators.

Prevents the keyboard being used to enter text in the object.

RGB color in which the object's background is displayed when the object is active and in read-only mode.

The property's value corresponds to a RGB color. Each color has a red, green and blue component in the range [0 ; 255]. The value of the resultant color is calculated as follows: Color = B*65536 + G*256 + R . Some values are predefined using the constants listed below.

Note: This property is not implemented by the Java generator.

RGB color in which the text in the object is displayed when the object is active and in read-only mode.

The property's value corresponds to a RGB color. Each color has a red, green and blue component in the range [0 ; 255]. The value of the resultant color is calculated as follows: Color = B*65536 + G*256 + R . Some values are predefined using the constants listed below.

Note: This property is not implemented by the Java generator.

Allows text color to be displayed in reverse, by swapping the text and background colors.

Does not display an asterisk instead of each character entered on the keyboard.

Used to enter password type text, when the property is set to *FALSE.

Draws an edge around the object.

Allows the object to be placed in focus using the keyboard (TAB key or SHIFT+TAB).

RGB color in which the text in the object is displayed when the object is active but not in read-only mode.

The property's value corresponds to a RGB color. Each color has a red, green and blue component in the range [0 ; 255]. The value of the resultant color is calculated as follows: Color = B*65536 + G*256 + R . Some values are predefined using the constants listed below.

This property specifies whether or not the ToolTip is displayed.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Background RGB color of the ToolTip corresponding to the object.

The property's value corresponds to a RGB color. Each color has a red, green and blue component in the range [0 ; 255]. The value of the resultant color is calculated as follows: Color = B*35536 + G*256 + R . Some values are predefined using the constants listed below.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Distance (in pixels) between the bottom edge of the ToolTip and the bottom of the text.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

By default, the ToolTip is displayed to the bottom-right of the mouse pointer, possibly overlapping part of the entry field. If the ToolTip is center-adjusted, it is displayed below the entry field, centered relative to it.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Used to delete (or retain) any ampersand characters ('&') in the ToolTip text. This property is useful where the text is from a menu option.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Length of time (in ms) during which the ToolTip is displayed.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Character font used to display the ToolTip text.

The string format contains the name, size, style and script, in that order. A semi-colon must be inserted between each element.

If you set a property's value, you MUST specify the name and size.

The different styles are specified using the following values:

• • 1: Normal (no special style)
  • 2: Strikethrough
  • 16: Italics
  • 256: Bold
  • 4096: Underlined

The style value to be specified in the string can either be one of the above values or else the sum of values other than 1.

The different script values are as follows:

Note:

The size, style and script must be compatible with the chosen font. The Windows system font selection dialog box, accessible via the graphical object's Properties pages, provides a guide for selecting coherent values.

This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Distance (in pixels) between the left-hand edge of the ToolTip and the left of the text.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Maximum width (in pixels) allowed for the ToolTip. By default, the ToolTip text is displayed on a single line. To display the text on more than one line, you must either specify a maximum width for the ToolTip or else enter a text containing carriage returns (characters with the decimal values 13 and 10).

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

When the ToolTip is permanently active, it is displayed even if the entry field is placed in a window other than the currently active window.

Notes:

This property is not implemented by the Java generator.

It is not  available in Mobile generation for Pocket PC and Smartphone platforms.

Distance (in pixels) between the right-hand edge of the ToolTip and the right of the text.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Text used in the ToolTip. If this text is not specified during the layout design phase, the entry field will not have a ToolTip when it is executed.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

RGB color of the text of the ToolTip associated with the object.

The property's value corresponds to a RGB color. Each color has a red, green and blue component in the range [0 ; 255]. The value of the resultant color is calculated as follows: Color = B*35536 + G*256 + R . Some values are predefined using the constants listed below.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Pause (in ms) between the moment the mouse pointer stops over the entry field and the moment the ToolTip is displayed.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Distance (in pixels) between the top edge of the ToolTip and the top of the text.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Value associated with the object.

Defines how the graphical control is adjusted when the window is resized vertically.

Note: This property is not implemented in Java and Mobile generation.

Allows the use of a vertical scroll bar for viewing the text in the object.

Visibility of the object.

Width value of the object.

X coordinate value of the object's position relative to the area covered by the window, page or pane.

The reference point (origin) is the top left corner of the object.

Y coordinate value of the object's position relative to the area covered by the window, page or pane.

The reference point (origin) is the top left corner of the object.

• Page:
  ENTRY FIELD (Visual Adelia Context)
• Page:
  Events of the ENTRY FIELD Object
• Page:
  Methods of the ENTRY FIELD Object
• Page:
  Properties of the ENTRY FIELD Object