DataGrid 小组件

DataGrid 小组件在运行时会在 InTouch 窗口内展示表格数据。用户可对小组件内数据进行筛选。

尽管小组件在 InTouch HMI 和 AVEVA OMI 中使用相同的属性，但在 InTouch 运行时，数据加载和行选择的行为有所不同。

该小组件支持一系列视觉属性，可自定义小组件外观与表格数据展示样式。

支持的数据格式

DataGrid 小组件支持 JSON 和 CSV 数据格式。数据通过 DataSource 属性以字符串形式提供给小组件，或在运行时动态提供。

JSON 示例

[

  {

    "Equipment Name": "Feed Pump P-101",

    "Equipment ID": "P-101",

    "Equipment Type": "Centrifugal Pump",

    "Area": "Tank Farm",

    "Status": "Running",

    "Last Maintenance Date": "2025-11-14",

    "Location City": "Houston",

    "State": "TX",

    "Zip": "77002"

  },

  {

    "Equipment Name": "Boiler B-201",

    "Equipment ID": "B-201",

    "Equipment Type": "Steam Boiler",

    "Area": "Utilities",

    "Status": "Online",

    "Last Maintenance Date": "2025-09-30",

    "Location City": "Baton Rouge",

    "State": "LA",

    "Zip": "70801"

  }

]

CSV 示例

Equipment Name, Equipment ID, Equipment Type, Area, Status, Last Maintenance Date, Location City, State, Zip Feed Pump P-101, P-101, Centrifugal Pump, Tank Farm, Running, 2025-11-14, Houston, TX, 77002 Boiler B-201, B-201, Steam Boiler, Utilities, Online, 2025-09-30, Baton Rouge, LA, 70801

运行时筛选数据

网格的每一列数据均可筛选。应用筛选后，Data Grid 小组件仅显示列项匹配筛选条件的行数据。

下例展示了在“周”列应用筛选器（仅显示周四的数据）前后，表格数据的对比。

选择各列标题中的筛选图标 ，将显示一个下拉窗格，用于指定筛选条件。

属性

下表列出了 DataGrid 小组件的属性。所有属性都公开为动态运行时属性，在这些属性中，它们可以绑定到对 ViewApp 命名空间的引用，如下所示：

• 属性

• 对象属性

• MyContent 属性

• 复合表达式

  Data Grid 小组件属性	描述
  类型	获取或设置源数据字符串的格式。 csv json
  AllowExport	允许将数据导出到文件。缺省值为 true。
  数据来源	获取或设置 DataGrid 小组件显示的 JSON 或 CSV 数据字符串。
  ColumnDelimiter	获取或设置用于分隔所选网格行中字段值的分隔符。 csv 字符串的逗号 json 字符串的垂直管道 (|)
  SelectedRow	获取或设置所选行字段值的字符串。
  DateFieldFormat	获取或设置日期的日期格式。支持所有日期格式字符串。
  BackgroundColor	小组件的背景颜色。
  ExportFileName	如果 AllowExport = True，则指定导出文件的名称。
  FilterMode	获取或设置网格的筛选模式；可选值为 default 或 checklist。
  前景色	获取或设置小组件的文本颜色。
  HeaderBackColor	显示列名的表格标题的背景颜色。
  HeaderForeColor	标题列名的文本颜色。
  SelectionBackColor	网格中所选行的背景颜色。
  SelectionForeColor	网格内所选行的文本颜色。
  RowHoverBackColor	鼠标悬停时网格内该行的背景颜色。
  RowHoverForeColor	鼠标悬停时网格内该行的文字颜色。
  Font Family	小组件用于显示文本的字体系列名称。
  字体大小	获取或设置 Data Grid 小组件中显示的文本的字体大小（以像素为单位）。
  PageSize	获取或设置一次要显示的记录数。

  注意：
  当数据在运行时动态加载时，在 DataGrid 小组件中选择一行可能会导致网格重置为设计时数据。
  DateFieldFormat 属性是必需的，但系统在运行时不会对其进行验证。