skip to main content
OpenEdge Development: AppBuilder
Data-Display/Capture Objects : Multi-line editors
Multi-line editors
The Editor widget provides the ability to capture large amounts of text in a way familiar to and convenient for the user. You might use an editor object to capture, for example, free‑form comments of undetermined length.
Although they are basic ABL objects rather than SmartObjects, you can add a considerable amount of additional capability to them through calls to ABL methods for searching and other functions.
Creating an editor instance
Because the Editor widget is a basic ABL object, creating one is very simple.
To create an Editor widget:
1. Click Editor in the Object Palette.
2. Move the mouse cursor over a bare spot in your workspace and click to place the new Editor object.
3. Configure and size it.
Configuring an editor instance
You can change some basic characteristics of the editor widget’s appearance and behavior through its property sheet, if the default settings do not meet your needs. Note, however, that the more sophisticated behaviors, such as searching, cannot be enabled in the property sheet.
To configure your editor object, begin by selecting the object and choosing ToolsProperty Sheet. The Property Sheet dialog box appears:
Minimal configuration
Although you might choose to accept the other default settings, you should make at least the first of these two changes:
*Change the default identifier to one that more closely reflects the role of this object in your application.
*Turn off the Horizontal scroll bar and turn on Word Wrap. The default style produces a single long line of input unless the user explicitly uses the RETURN key. This might not be the most appropriate style for the needs of your application.
Edit‑buffer size
The default size of an editor widget’s buffer is 20KB under Windows. You can reduce memory requirements by forcing a smaller buffer size. Enter the desired value in the Maximum Characters field.
Add one or both of these help elements:
*Add a Tooltip string, if appropriate. The editor will display that string whenever the user allows the mouse cursor to hover over the widget.
*If you will provide context‑sensitive help for this object, add a unique integer Help ID.
AppBuilder allows you to adjust the position and size of your widgets interactively, by dragging their handles. The changes you make in this way are reflected in the Geometry values. You can also change these values explicitly, here.
AppBuilder normally generates source code that identifies the upper‑left corner of the object as its origin. You can choose to have the upper‑right corner identified as the origin instead. This alignment setting does not change the actual position of the object in any way.
For more information on all the settings on the property sheet, see the online help.
Advanced properties
The editor widget has only the standard advanced properties, but you can change those that do not meet your needs. See the “Advanced properties” section for more information.