Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

Edge HMI

Columns dialog

  • Last UpdatedOct 29, 2026
  • 6 minute read

This topic describes the Columns properties of the Grid object.

Column properties for a 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.

Related Links