Text properties
The Text part has the following properties:
alignment
The alignment property specifies that the text, icon, or bitmap can be aligned either left, right, or centered. On some platforms, the alignment for push buttons, toggle buttons, and cascade buttons cannot be set and is ignored. The possible values are as follows:
XmALIGNMENTBEGINNING
Left alignment
XmALIGNMENTEND
Right alignment
XmALIGNMENTCENTER
Center alignment
autoSelect
The autoSelect property indicates whether the text in the field should be automatically selected when the field gets focus.
autoTab
The autoTab property indicates whether tabbing should automatically occur when the textLimit is reached.
backgroundColor
The backgroundColor property is the name of the RGB color for the background of the part.
borderWidth
The borderWidth property is the width of the border, specified in pixels, that surrounds the part on all four sides. A width of zero means that a border does not show.
On some platforms, the border width is limited to 1 pixel and any nonzero value is set to 1.
columns
The columns property specifies the width of the part measured in average character spaces when either the left or right edge is not attached.
The width of the control determines the initial setting of the columns property unless another initialized value is connected to the property. You can modify the width of the control at run time by connecting a value to the columns property of the part.
converter
The converter property is an object that manages the conversion of other objects to and from their display format for certain visual parts, such as a Text part.
dragDropSpec (AbtDragDropSpec)
editable
The editable property specifies whether the text in the part can be edited.
Note:
For the Container Details parts, this attribute along with the columns attribute determine whether the column cells are editable. However, the various edit events (such as editCellAt: or editSelectedCell) will edit the column, regardless of the values of these attributes.
enabled
The enabled property specifies whether or not the part is available for selection. If true, the part's contents are available for selection.
fontName
The fontName property is the name of the font to use for the text displayed in the part.
foregroundColor
The foregroundColor property is the name of the RGB color for the foreground of the part.
framingSpec
The framingSpec property represents the values specified for the edge specifications of the part. The edge specifications determine the width, height, and position of the part.
helpFile
The helpFile property is the name of the help file associated with the part.
helpKeysId
The helpKeysId property is the ID of the keys help associated with the part. The ID can be a string or an integer value.
The ID must exist in the help file associated with the part.
helpTitle
The helpTitle property is the title of the help window associated with the part.
helpTopicId
The helpTopicId property is the ID of the help topic associated with the part. The ID can be a string or an integer value.
The ID must exist in the help file associated with the part.
maxLength
The maxLength property specifies how long a string of data can be in the field.
notifyChangeOnEachKeystroke
The notifyChangeOnEachKeystroke property specifies whether each keystroke sends a notification that the part has changed.
For example, if you connect the notifyChangeOnEachKeystroke property of a Text part to an action you want to occur, such as a validation routing, then the validation would occur after each keystroke within the entry field.
object
The object property is the data that the part represents. If the part represents non-string data, use this property; otherwise use the labelString or string property.
For example, you can use the object property with a converter to display the label of a button.
partName
The partName property specifies the name you want to use to describe the part. For nonvisual parts, this text appears under the icon for the part on the free-form surface.
The name of the part can consist of alphanumeric characters, and must be different from those of all other parts on the layout surface.
If you do not specify a part name, VA Smalltalk generates a unique name based on the class name of the part.
passwordCharacter
The passwordCharacter property contains the character that displays for every character that the user types when the part is protected by a password.
passwordProtect
The passwordProtect property specifies that the part has a password associated with it. The password character is displayed as the user types in the field.
reformatOnFocusChange
The reformatOnFocusChange property specifies whether the part, which has a converter specified, is reformatted when the focus changes.
tabGroup
The tabGroup property specifies whether or not the part is included as a tab stop so users can use the Tab and Backtab keys to access the part.
traversalOn
The traversalOn property specifies whether users can access the part using the cursor movement keys. If the part is specified as a tab stop by using the tabGroup property, users also can use the Tab and Backtab keys to access the part.