Data Table
The Data Table allows selectable data, from a table or database, to be presented on a user form.
When the form control is applied the name entered will display as the caption for the form control. This can be changed by selecting the Caption property.
Properties
Appearance
- Background Color
Specifies the color of the control's background.
- Column Widths
One or more values delimited by the | symbol. Setting one value applies that width to all columns.
- Header Background Color
Controls the background color of the headers.
- Header Cell Padding
Specifies the padding of header cells.
- Header Height
Controls the height of the header row.
- Row Background Color (Hover)
Specifies the background color to display on a row that the cursor is over.
- Row Background Color (Selected)
Specifies the background color of the selected row.
- Row Background Colors
Controls the background color of all rows, except the header row.
One or more values delimited by the | symbol. Setting one value applies that color to all rows.
- Row Cell Padding
Specifies the padding of row cells.
- Row Height
Controls the height of each row in the data table, except the header row.
- Show Filler Column
Appends a filler column at the end of each row to fill the remaining control width. If set to FALSE,
the final column of data will expand to fill the remaining control width, regardless of a column
width specified.
Appearance - Border
- Border Color
Specifies the color of the control's outer border when the 'SingleLine' border style is selected.
- Border Radius
Specifies the border radius of the control.
- Border Style
Configures the border style of the control.
- Border Width
Specifies the width of the control's border.
- Grid Line Color
Specifies the color of the data table's grid lines.
- Show Grid Lines
Specifies whether to show or hide the data table's grid lines.
Appearance - Text
Behavior
- Allow Copy
Specifies whether the context menu to copy from the control is enabled.
- Click Selected Row To Deselect
If TRUE, clicking a selected row will deselect it, otherwise if FALSE, you must deselect by
holding Ctrl and clicking.
- Default Row Identity
Controls the default identity value of the control, if the default identity value is based on a
rule and the value of the rule changes, then the selected identity value of the control will be
changed to be the default identity value.
- Default Row Index
Controls the default index of the control, if the default index is based on a rule and the value
of the rule changes, then the selected index of the control will be changed to be the default
index.
- Enabled
Controls whether the control is enabled (if the result is TRUE) or disabled (if the result is
anything other than TRUE, e.g. FALSE).
- Error Result
Determines whether the value of the control is in error. The result of this rule is a string
containing the error message if the value is in error, otherwise a blank string or the number
zero.
- Hidden Fields
A pipe-bar delimited list of fields which should not be displayed in the data table.
- Identity Fields
A pipe-bar delimited list of the names of the fields which, taken together, uniquely identity a
row in the table.
- Items
Data Table - The items to show in the table, in array format.
- Selected Row Index
Gets or sets the selection by index.
- Sort Allowed
If TRUE, allows the user to sort the data table by clicking the table headers, otherwise if
FALSE, sorting is disabled.
- Tab Index
Configures the position of the control in the form tab order.
- Visible
Determines whether the control is visible (TRUE) or hidden (FALSE).
General
- (Metadata)
Optional text which can be used to provide information belonging to or about a control. For example,
a list of CSS classes which can be parsed and applied to the control using the Integration Theme in
DriveWorks Live. This doesn't affect the control's behavior.
- (Name)
The name of the control
- (Tag)
Optional text which can be used to describe the control, but which doesn't affect the control's
behavior.
- Tooltip Duration
Controls the duration, in seconds, for which the tooltip will remain visible. Values of 0 and below
indicate an infinite duration.
- Tooltip Text
Specifies the text to display in a tooltip when hovering over the control.
Layout
- Height
Controls the height of the control.
- Left
Controls the left position of the control.
- Top
Controls the top position of the control.
- Width
Controls the width of the control.
DriveWorks Tech Tips Portal |
Custom Child Spec List How to create your own Child Specification List control which can be tailored to suit your forms, using a Data Table and Macro Buttons to reskin it. View all Tech Tips |
DriveWorks Tech Tips Portal is available to DriveWorks Pro customers with an active subscription and support contract. Tech Tips provide cut down projects that highlight specific functionality for faster and more effective learning. To access the portal: - Go to https://my.driveworks.co.uk/learn/tech-tips/
- Login with your DriveWorks Pro account credentials, if asked
- Click the Visit Tech Tips Portal button for access
The portal provides a search facility, start typing the name of the Tech Tip (as indicated above) to display the Tip you require. |