skip to main content
OpenEdge Development: AppBuilder
Data-Display/Capture Objects : Fill-ins (single-line editors)
Fill-ins (single-line editors)
The fill-in widget provides the ability to capture and/or display a small amount of text, typically a single token or short string. Fill-ins do not allow embedded line breaks. You can choose to have text captured by a fill-in undergo automatic type conversion and validation.
Creating a fill-in instance
Because the fill-in widget is a basic ABL object, creating one is very simple.
To create a fill-in widget:
1. Click Fill-in in the Object Palette.
2. Move the mouse cursor over a bare spot in your workspace and click to place the new object.
3. Configure and size it.
Configuring a fill-in instance
You can change some basic characteristics of the fill-in widget’s appearance and behavior through its property sheet, if the default settings do not meet your needs.
To configure your fill-in object, begin by selecting it and choosing ToolsProperty Sheet. The Property Sheet dialog box appears:
Minimal configuration
Although you can accept many of the default settings, you should at least make the following three changes:
*Change the AppBuilder‑generated object identifier to one that more accurately reflects the role of this fill-in in your application.
*Change the generic label to one that will be meaningful to the users of your application. Or, if appropriate, set the No Label check box to hide the label. Setting this check box does not clear the actual label text; the label string remains visible in the property sheet. The only other effect of setting or clearing this box is to alter the values in the Geometry section so that the fill-in stays at the same XY location within the enclosing frame.
*Click the Advanced button and set the initial value, if any, that the fill-in is to display. By default, the initial value is empty/undefined.
Internal data format
You can use a fill-in to capture any data type whose value can be entered from the keyboard and represented on the display as ordinary text. The fill-in will do a limited amount of syntax‑checking for you if you appropriately set the values for Define As and Format.
*Define as — Choose the data type from the list. The default type is CHARACTER, but you can choose DATE, DATETIME, DATETIME-TZ, DECIMAL, INTEGER, INT64, or LOGICAL instead.
*Format — Enter the formatting string for the data type you have chosen. If you would prefer to pick the format string from a list rather than enter it by hand, click Format to open a dialog box specific to the type you have chosen. Shown here is the dialog box that displays for type CHARACTER:
You can supply helpful information to your users in several ways. Here are two of the most common:
*Add a Tooltip string. Under Windows, Tooltips display whenever the user allows the mouse cursor to hover for a few seconds over an object for which a Tooltip is defined.
*Add a unique integer as the identifier for context‑sensitive help, if you plan to provide such help as part of your application.
Reflects the XY origin and size, in character units, of the fill-in. By default, the fill-in is colon‑aligned. You can change that to left‑ or right‑alignment, though the only noticeable effect that will have is to change the X origin value.
For more information on all the settings on the property sheet, see the online help.
Advanced properties
A fill-in 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.