Columns dialog
- Last UpdatedOct 29, 2026
- 6 minute read
This topic describes the Columns properties of the Grid object.

Column
This number indicates the order of the columns in the grid, from left to right. To reorder the columns, use the Move Up and Move Down buttons at the bottom of the dialog box.
Label
Type a label for the column, which will be displayed in the header row of the grid. This field accepts String expressions.
When the label is blank, the width of the entire column is set to 0. You can do this to hide columns during project run time.
This option is not available if the Show header option in the Advanced settings is not selected.
Member
Enter the name of the class member to which this column will be linked. If this field is left in blank, the text configured in the Label field will be used as a default member name.
This setting is available only when the Grid object's data source is set to Class Tag.
Field
Enter the name of the field (column) in the database table to which this column will be linked. If this field is left in blank, the text configured in the Label field will be used as a default field name.
You can configure valid SQL statements directly in the field (for example, List(DISTINCT [Cell_Name]) AS [Cell Name]). This field accepts String expressions.
This setting is available only when the Grid object's data source is set to Database.
Type
Select the data type of the values that will be displayed in the column. In particular, when the Grid object's data source is set to Database, make sure the Type configured for each column of the grid matches the data type of the corresponding field in the database. The following types are available:
|
Type |
Description |
|---|---|
|
Text |
Display string values (that is, alphanumeric text). |
|
Numeric |
Display numeric values. |
|
Picture |
Display the specified image file (.bmp or .ico) located in the Web sub-folder of your project folder. For example, if the value from the data source is MyFile.bmp, the Grid object will display the image file located at <project name>/Web/MyFile.bmp. If it is a .bmp file, the image may be resized or stretched to fit the column. If it is an .ico file, which can contain several scaled versions of the same image, the version that best fits the column will be automatically selected and then resized if necessary. In both cases, resized images cannot be aligned in the column (that is, the Align setting for the column will have no effect). If the specified image file cannot be found during project run time, a default image is displayed instead. To change the default image, manually edit your project file (<project name>.APP) to change the following property: [Objects] GridDefaultPicture=<file name> Note: Projects running on Windows Embedded support .bmp files but not .ico files. |
|
Check-box |
Display the values, typically Boolean, as check boxes. While a value is TRUE (that is, non-zero), the check box is selected. While a value is FALSE (that is, zero) or NULL, the check box is cleared. If the Input option is selected for the column, and the user selects or clears the check box during project run time, the value is set to 1 or 0, respectively. This is true even if the value is not Boolean. Therefore, it is possible for a large numeric value (for example, 1000) or even a string value to be reset to 1 when the check box is cleared and then selected again. |
|
Time |
Display the values in the time format (for example, HH:MM:SS). This type is available only when the Grid object's data source is set to Database, because each value is assumed to be a database timestamp that can be parsed to get the actual time. |
|
Date |
Display the values in the date format (for example, MM/DD/YYYY). This type is available only when the Grid object's data source is set to Database, because each value is assumed to be a database timestamp that can be parsed to get the actual date. |
|
Date/Time |
Display the values in the date/time format (for example, MM/DD/YYYY HH:MM:SS). This type is available only when the Grid object's data source is set to Database, because each value is assumed to be a database timestamp that can be parsed to get the actual date and time. |
|
Time ā UTC |
Display the values in the time format (for example, HH:MM:SS). This type is available only when the Grid object's data source is set to Database, because each value is assumed to be a database timestamp that can be parsed to get the actual time. Also, the timestamp is assumed to be in Coordinated Universal Time (UTC), and it is automatically converted to the local time zone in the project viewer / thin client. |
|
Date ā UTC |
Display the values in the date format (for example, MM/DD/YYYY). This type is available only when the Grid object's data source is set to Database, because each value is assumed to be a database timestamp that can be parsed to get the actual date. Also, the timestamp is assumed to be in Coordinated Universal Time (UTC), and it is automatically converted to the local time zone in the project viewer / thin client. |
|
Date/Time ā UTC |
Display the values in the date/time format (for example, MM/DD/YYYY HH:MM:SS). This type is available only when the Grid object's data source is set to Database, because each value is assumed to be a database timestamp that can be parsed to get the actual date and time. Also, the timestamp is assumed to be in Coordinated Universal Time (UTC), and it is automatically converted to the local time zone in the project viewer / thin client. |
For more information about the date format, see About the date format and how to change it.
Width
Enter the width of the column, in pixels.
You can type the name of an Integer tag for this setting (for example, Column1Width). When the value of the tag changes during project run time, the width is changed to match.
Note: When the Grid object's data source is set to Class Tag, if the Label field is configured but the Member field is not, then the Width setting is ignored and the column is auto-sized to fit its contents.
Align
Select the horizontal alignment for the data displayed in the column. There are three options: Left, Right, or Center.
Input
Select this option to allow the user to enter data in the column during project run time.
Key
Click the More button (ā¦) and then use the Key Modifier dialog box to define a shortcut key for the column. When the user presses the shortcut key during project run time, the rows of the grid are sorted according to the values in the column. This is an alternative to clicking or tapping the column's label, so it is especially useful if you are developing your project for a device that has a keyboard but not a mouse or touchscreen.
The shortcut key is useful only if Allow sorting columns option is selected (see below).
Unit
Enter the name of the engineering unit (that is, the unit of measurement), if any, that applies to the data to be displayed in the column. This field accepts String expressions. When the value of the expression changes during project run time, the engineering unit is changed to match.
Decimal Points
Enter the number of decimal places to be displayed in the column, if the column is configured to display numeric values.
You can type the name of an Integer tag for this setting (for example, Column1Decimals). When the value of the tag changes during project run time, the number of decimal places is changed to match.
Show ID Column
This option, which is selected by default, displays an additional column of ID numbers for the rows of the grid.
Allow sorting columns
This option, which is selected by default, allows the user to sort the rows of the grid according to the values in a selected column. To select a column during project run time, the user can either click/tap the column's label or press the column's shortcut key.
Note: When the Grid object's data source is set to Class Tag, if the entire Columns dialog box is left blank, then the grid automatically displays the values from all class members with the following default settings:
|
Setting |
Value |
|---|---|
|
Label |
The name of the class member. |
|
Type |
Text |
|
Width |
The minimum size to display the name of the class member on the header row of the grid. |
|
Align |
Center |
|
Input |
Enabled (selected). |
|
Key |
None. |
|
Unit |
The engineering unit of the class member. |