Setting the Properties of a Form

The visual characteristics that you specify for a form are inherited by all graphical objects that you add to the form, when they are appropriate for an object type. You can specify different visual attributes for a particular object or group of objects after the objects have been added to the form. If you want to return the changed visual attribute of an object to its original inherited value, select the object and the property that you want to reset, click Reset from the context menu.

To set the properties of a form in the Properties window, perform the following:

  1. Click anywhere on the form to select the form.

  2. On the View menu, right-click Properties to open the Properties window.

  3. Specify the properties as listed in the following table.

Property

Function

Name

Specifies the name of the element that contains the form.

This property is read-only.

GridSize

Specifies the size in pixels of the horizontal and vertical guidelines to help you align objects on a form.

The grid size might differ between Graphical and Fixed screens. The grid size depends on the fixed type font and font size for a Fixed screen.

ShowGrid

Specifies whether the form displays grid lines. By default, the grid is turned on.

SnapToGrid

Specifies whether the objects on the form get locked to the nearest grid lines. The default value is True.

FormLayout

Specifies the display format of form objects. By default, the Grid option is selected.

The following two options are available:

  • Grid – Specifies absolute positioning behavior of form objects.

  • Flow – Specifies a logical flow layout of form objects in a top-left, bottom-right arrangement.

Auto Tabbing

Specifies if the cursor automatically moves to the next field on the form after data is entered in the current field. Options include True and False.

Note: This option is applicable only for the Presentation and Winform clients.

BackgroundColor

Specifies a background color for the form. Select a color from one of the tabs in the drop-down list. The colors for a Fixed screen are limited to the following: Black, White, Red, Green, Blue, Yellow, Cyan, and Magenta.

Font

Specifies font attributes that are applied directly to the text appearing on the form. The fonts for a Fixed screen are limited to fixed type fonts only. Any font change applies to all items in a form.

ScrollBars

Specifies if a form displays scroll bars when the content of a form exceeds a screen display size.

The following options are available:

  • No

  • Horizontal

  • Vertical

  • Both

ShowActmth

Specifies whether the accounting month field appears. Options are True (default) and False.

ShowHeader

Specifies whether the header fields of a form appear. Options are True (default) and False.

Show ToolTip

Specifies an optional tool tip to appear when the user at runtime hovers the mouse over a control in Winforms. To view the tooltip in the Presentation Client, you have to hover the mouse on the control and press the F1 key. This tooltip is only visible at Runtime.

Size

Specifies the size of the form representing the height and width in pixels. By default, it is 80 by 24 pixels. You can adjust the size, if needed.

TransmitToCursor

Specifies that the form data up to the position of the cursor (in the order of tabbed fields) is transmitted to the host.

By default, the value is False, and it sends all the form data to the host at transmit time.