Welcome > Form Designer module > Form controls > Basic controls > Properties of a Cell

Properties of a Cell

Name

By default, the cell ID appears as the name of the cell. Change the ID to make the cell easier to identify during mapping.

Title

Add a title to the cell. If you set the cell to collapsible, the title appears at runtime.

Security Token

Restrict access to the cell contents at runtime by applying a security token to a cell. See Security Tokens.

Note You can use the same security token for multiple cells. Importing or exporting a form includes security tokens associated with a cell.
Orientation

  • Vertical: Displays the cell controls vertically.

  • Horizontal: Displays the cell controls horizontally.

Visible

Choose whether the control be visible at runtime. (Default: Yes)

Note If you set the cell as hidden, all the controls within the cell are hidden. So if you want to hide only some controls in a cell, then you must put other controls in a different cell.
Collapsible

Choose whether the cell can be collapsible (collapse or expand) at runtime. (Default: No)

If you set the cell to be collapsible, set the Header Style (Theme, Inline or Class) for the cell.

Collapsed

Have the cell collapsed by default at runtime. (Default: No)

Note This property does not appear on Phone and Tablet forms.
Design

  • Width: The width of the cell.

  • Min Height: The minimum height of the cell.

  • Padding: To create space between the text inside a cell and the cell border, enter the values for the Left, Top, Right and bottom padding.

  • Alignment (default: None): To select the alignment as Left, Center or Right for the controls in a cell.

    Note If a cell has many controls with horizontal orientation, and the alignment is left, center or right, some of the controls may get cut off at runtime.

  • To set the Style for a cell, select one of the following:

    Theme

    Keeps the default theme.

    Themes are defined globally (outside of forms and sites) and are then associated with a site. Forms are rendered as part of a site. The theme associated with the site determines the style for the controls.

    Inline

    Define a style for the control by setting the following:

    • Border: Set the borders for a cell so that you can specify which edges have borders, and also prevent adjacent cells from having duplicate borders.

      Set a numeric value for Left, Top, Right and Bottom borders (default: 0). At runtime, the edges for which a border value is set are displayed with a border. If an edge has its border set to 0, this means there will be no border on that edge. If there are adjacent cells, and if both the adjacent edges have borders set, then a duplicate border is visible. But, if only one edge has a border set, only that border is displayed.

      Note

      • The Border property is only available for a Cell control.

      • On upgrading TotalAgility, or on importing an older form from a previous version that has a border value set, the same value is set for left, top, right and bottom borders.

    • Border Color: To set a border color for a cell, click the Down arrow and select the color to use. (Default: Blue, #FF99BCE8)

    • Background: To set a background color for a cell, click the Down arrow and select the color to use. (Default: Transparent)

    • Use Background Image: Set a background image to a cell to enhance its look. (Default: No)

      1. Click Yes for Use Background Image and enter an image name or URL in the Image Path box.

        Note For on-premise TotalAgility, the image must reside in <Installation location>\Kofax\TotalAgility\Agility.Server.Web\Forms\Images.

        Alternatively, to load an image from store, click Yes for Load Image from Store (default: No) and consume an existing image or enter the image name, such as Add.png in the Image Path box.
      2. By default, the image uses the original size. To fit the image to the size of the cell, click Yes for Resize To Fit. (Default: No)

    Class

    Enter the name of the CSS class. This class is applied to the control only when it is available in the style sheet that is associated with the theme. If the class does not exist in the style sheet, the control uses the default style.

    Note This property appears for File Upload, Language Selector, Resource Tree controls and all basic controls.