3.5.2.1.50. 树形数据网格

在线示例

API 文档

TreeDataGrid, 类似于DataGrid组件，用于显示和排序表格式数据，并提供显示层级结构数据和操作行列的方法，这些行和列由于只在滚动时按需加载数据，因而性能更好。

该组件用于显示具自引用关系的实体。例如，它可以用于展示文件系统或公司组织结构图。

该组件对应的 XML 名称： treeDataGrid

对于 TreeDataGrid，应该设置两个属性：dataContainer，它将 treeDataGrid 绑定到数据容器；hierarchyProperty，它是引用同一实体的实体属性的名称。

在界面 XML 描述中定义的组件示例：

<data readOnly="true">
    <collection id="departmentsDc" class="com.company.sales.entity.Department" view="department-view">
        <loader id="departmentsDl">
            <query>
                <![CDATA[select e from sales_Department e]]>
            </query>
        </loader>
    </collection>
</data>
<layout>
    <treeDataGrid id="treeDataGrid" dataContainer="departmentsDc" hierarchyProperty="parentDept">
        <columns>
            <column id="name" property="name"/>
            <column id="parentDept" property="parentDept"/>
        </columns>
    </treeDataGrid>
</layout>

TreeDataGrid 的功能类似于简单的DataGrid。

treeDataGrid 的属性

align - caption - captionAsHtml - colspan - columnResizeMode - columnsCollapsingAllowed - contextMenuEnabled - css - dataContainer - datasource - description - descriptionAsHtml - editorBuffered - editorCancelCaption - editorEnabled - editorSaveCaption - enable - box.expandRatio - frozenColumnCount - headerVisible - height - hierarchyProperty - icon - id - reorderingAllowed - responsive - rowspan - selectionMode - settingsEnabled - sortable - stylename - tabIndex - textSelectionEnabled - visible - width

treeDataGrid 的元素

actions - buttonsPanel - columns - rowsCount

columns 的属性

includeAll - exclude

column 的属性

caption - collapsed - collapsible - collapsingToggleCaption - editable - expandRatio - id - maximumWidth - minimumWidth - property - resizable - sortable - width

column 的元素

formatter

API

addGeneratedColumn - applySettings - createRenderer - edit - saveSettings - getColumns - setDescriptionProvider - addCellStyleProvider - setConverter - setDetailsGenerator - setEnterPressAction - setItemClickAction - setRenderer - setRowDescriptionProvider - addRowStyleProvider - sort

树形数据网格的监听器

ColumnCollapsingChangeListener - ColumnReorderListener - ColumnResizeListener - ContextClickListener - EditorCloseListener - EditorOpenListener - EditorPostCommitListener - EditorPreCommitListener - ItemClickListener - SelectionListener - SortListener