The Line (

) form object places a horizontal or vertical line in a form to separate groups of form objects.
Choose the orientation of the divider line in the Orientation list:
Horizontal (the default) or
Vertical. For the
Horizontal divider, you can also add text that appears within the horizontal line. To add such text, select the
Include divider text check box and enter text in the associated
Text field.
In addition, the Settings window contains the following sections.
The need to specify the alignment is most obvious when working in the grid mode, as it controls how the form object is aligned in its grid cell. Aligning the form object can be useful in the sketch mode too, and you can then use the alignment tools on the Arrange menu in the
Form toolbar’s
Sketch section. When running the application in any client other than the Windows client, the form objects may not be positioned exactly as seen in the Application Builder. This is because the form objects may have a different size in other clients, giving them a slightly different positioning. Specifying the alignment ensures that the form objects are aligned as you want them to be in all clients.
You can also specify the width of a horizontal line, unless you have chosen Fill from the
Horizontal alignment list. Enter a width (in points) in the
Width field. The
Height field is unavailable because the height of the horizontal line is determined by the software. For a vertical line, you can instead specify the height, unless you have chosen
Fill from the
Vertical alignment list. Enter a height (in points) in the
Height field. The
Width field is then unavailable because the width of the vertical line is determined by the software.
Additionally, in the sketch mode, you can specify the absolute position of the line using the Position x and
Position y fields. In the grid mode, you can position the object in the grid and see the grid position as the
Row,
Column,
Row span, and
Column span values.
Under Cell margin (in grid mode only), you can control the margins around the form object. By default, the margins are taken from the parent form. From the
Cell margin list, choose:
From the Text color list, select a color to use for the divider text:
Inherit (the default; the form object then uses the setting from the Form it is located in), any of the predefined basic colors, or
Custom, which makes it possible to select a custom color from a color palette.
The font and the font size for the divider text use the font settings from the Forms node by default. Select a font from the
Font list:
Default font or any of the available fonts. If needed, choose or enter a font size (in points) in the
Font size combo box. The default is to use the
Default size for the font.
You can also select the Bold check box to use a boldface font or the
Italic check box to use italics (an italic font).
To change the line thickness, enter another thickness value (as a positive integer) in the Line thickness field (default: 1). Choose a color for the line from the
Line color list (the
Default option is a gray line). Choose
Custom to define a custom color using a color palette.
Under State, you can control the initial state of the line when users run the application. By default, the line is visible and enabled. Clear the
Visible or
Enabled check box if you want to make the initial state so that the line is hidden or unavailable. You can then make it visible or enable it using a method. In the Form Editor, the state of the form object is indicated by a change in its appearance. Objects that are hidden become visible when selected in the Form Editor.