Width Property

Version: Available from runtime version 1.0.

Sets the width of a field when it appears as a column in a list. The width is specified by an integer that corresponds to the number of characters.

Applies to

  • Table Field
  • Page Field
  • Page Label

Syntax

Width = Integer;

Remarks

You use the Width property to help to improve readability in lists. The property only takes effect on pages of the type List, ListPlus, ListPart, Document, or Worksheet; when the field control is used in a repeater control. It has no effect on Card pages.

  • If you omit the property or set it to 0, the platform will automatically determine the optimal value based on the field's data type and other columns in the list.

  • Setting the property on a table field means that any page that uses the field will inherent the width from the setting on the table. However, if the property is set on both the page and its source table, the value of the property on the page is used.

  • Because font sizes can vary depending on the screen, the specified number of characters might not display entirely.

  • Users can override the width by personalizing the page that displays the field.

  • You can use Designer to adjust column widths.

Example

The following example sets the column width of a field to 50 characters.

 repeater(GroupName)
            {
                field(MyField; MyField)
                {
                   ApplicationArea = All;
                   Width = 50;
                }

            }

See Also

Properties
Use Designer
Personalizing Your Workspace