Creating and Editing Tables

There are numerous ways in which you can implement table controls to display host data in a tabular form. The most basic method, which is described in the following procedure, is to use a host table bound to a table control.

Note Depending on the design of your host screens and the environment in which you are working, you may also choose to use Web services, output from custom functions, or a variety of other individualized approaches.

Tables created using the following procedure include three elements:

Table element Definition
Host table The rectangular area of the host screen that contains the data you want to display.
Table control The GUI element in which the host data is displayed.
Binding The defined relationship between the host table and the table control.
Note If you autogenerate a table control from a host table using the Table editor, an input binding is automatically created between the host table and the table control.

However, if you choose not to autogenerate the table control, or if you want to bind the host table to more than one table control, you can manually create a table control using the Control palette, and then bind it to the host table using the Table Binding editor.

To create a table using a host table bound to a table control
  1. Create a new project or open an existing project.

  2. In the Editor pane, select the Customize tab.

  3. In the Project pane, right-click the active form, then choose Define/Edit Table.

    The Table Editor appears.

  4. In the Screen View pane, drag the mouse to capture the area you want to include in your table.

    Your selection appears framed in gold. Only the data within the gold frame is available to be viewed within your finished table.

    Note If you want to change the size of the selected area, you can either delete the table and begin again, or adjust the Start Point and/or End Point under Table Properties.
  5. Drag the pointer to select the first row of each column of data within your table.

    The columns are outlined in gold; the selected column is outlined in red.

  6. If necessary, edit the table and column properties.

  7. Click OK.

    Unless you've turned off the prompt, a message box appears asking if you want to autogenerate the table control from the defined host table.

  8. Click Yes to autogenerate the table control.

    A table control is automatically generated, bound to the host table, and then placed on the active form.

    -or-

    Click No to use the Table Binding editor to bind the host table to a table control created using the Control palette.

To edit a host table
  1. Open an existing project.

  2. In the Editor pane, select the Customize tab.

  3. In the Project pane, right-click the active form, then choose Define/Edit Table.

    The Table Editor appears, with the host table outlined in gold.

  4. From the drop-down list, select the table or column that you want to modify, and then make the desired changes.

To edit a table control
  1. Open an existing project.

  2. In the Editor pane, select the Customize tab, then select the table control or the column within the table control.

    The properties for the selected table control or column appear in the Properties pane. Modify the properties as desired.

To delete a host table or column
  1. Open an existing project.

  2. In the Editor pane, select the Customize tab.

  3. In the Project pane, right-click the active form, then choose Define/Edit Table.

    The Table Editor appears.

  4. From the drop-down list, select the table or column that you want to delete, and then choose Delete.

    A message box appears, to confirm your selection.

    Note If the host table or column you are attempting to delete has been bound to a table control, an error message will appear instead, and you will be prevented from making the deletion.

    Before you can delete a host table or column that has been bound to a table control, you will need to delete the input bindings (using the Table Binding editor). For more information, see the Binding Host Tables to Table Controls topic.

To delete a table control or table control column
  • To delete a table control, right-click it, then select Cut.

    -or-

  • To delete a table control column, right-click the column, select Table Columns, then select Delete Column.

Working with Tables, Overview
Binding Host Tables to Table Controls
Adding Web Services to Events
Custom Functions, Overview
Table Rules Syntax