TreeViewDelegate QML类型

可用于分配给TreeView的委托。 更多...

• 包括继承成员在内的所有成员列表

属性

• 当前 : bool
• 深度 : int
• 编辑 : bool (自 6.5)
• 展开 : bool
• 有子项 : bool
• 缩进 : real
• 是树节点 : bool
• 左边距 : real
• 右边距 : real
• 已选择 : bool
• TreeView : TreeView

详细介绍

TreeViewDelegate是可用于分配给TreeView的delegate属性的委托。它使用应用程序样式渲染树以及其他列。

TreeView {
    anchors.fill: parent
    delegate: TreeViewDelegate {}
    // The model needs to be a QAbstractItemModel
    // model: yourTreeModel
}

TreeViewDelegate继承自ItemDelegate，这意味着它由三个元素组成：一个背景，一个内容项，以及一个指示器。TreeViewDelegate会根据内容项和指示器在树中的位置进行缩进处理。只有当委托项位于树列内时，指示器才会可见，并渲染具有子项的模型项。

如果您更改了指示器，它将不会默认缩进。取而代之，您需要自己通过设置指示器的x位置来实现缩进，并考虑深度和缩进。以下是一个示例：

TreeViewDelegate {
    indicator: Item {
        x: leftMargin + (depth * indentation)
    }
}

内容项的位置由填充控制。这意味着您可以在不处理缩进的情况下更改内容项。但这也意味着您应避免将填充更改为其他值，因为这将移除缩进。指示符左侧的空间由leftMargin控制。指示符和内容项之间的空间由spacing控制。而内容项右侧的空间由rightMargin控制。

与指针交互

TreeViewDelegate 继承了ItemDelegate。这意味着当用户点击代理时，它将发出信号，例如clicked。如有需要，您可以连接到此信号以实现特定于应用程序的功能，包括默认的展开/折叠行为（甚至可以将pointerNavigationEnabled设置为false，以禁用默认行为）。

但ItemDelegate API 并不提供有关点击位置或哪些修饰符正在按下的信息。如果需要这些信息，则更好的方法是将指针处理器，例如

TreeView {
    id: treeView
    delegate: TreeViewDelegate {
        TapHandler {
            acceptedButtons: Qt.RightButton
            onTapped: someContextMenu.open()
        }

        TapHandler {
            acceptedModifiers: Qt.ControlModifier
            onTapped: {
                if (treeView.isExpanded(row))
                    treeView.collapseRecursively(row)
                else
                    treeView.expandRecursively(row)
            }
        }
    }
}

在树中编辑节点

TreeViewDelegate 默认分配有一个编辑代理。如果TreeView设置了编辑触发器，并且模型支持编辑模型项，则用户可以激活任意一个编辑触发器来编辑当前树节点的文本。

默认编辑代理将尝试使用Qt.EditRole来读取和写入模型中的数据。如果QAbstractItemModel::data()为此角色返回一个空字符串，则将使用Qt.DisplayRole代替。

如果您对默认编辑代理提供的内容有超出需求，可以为TableView.editDelegate分配自己的自定义编辑代理。

另请参阅：TreeView。

属性文档