TreeViewDelegate QML Type

Ein Delegat, der einem TreeView zugewiesen werden kann. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• current : bool
• depth : int
• editing : bool (since 6.5)
• expanded : bool
• hasChildren : bool
• indentation : real
• isTreeNode : bool
• leftMargin : real
• rightMargin : real
• selected : bool
• treeView : TreeView

Detaillierte Beschreibung

Ein TreeViewDelegate ist ein Delegat, das dem delegate property eines TreeView zugewiesen werden kann. Es rendert den Baum, sowie die anderen Spalten, in der Ansicht unter Verwendung des Anwendungsstils.

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

TreeViewDelegate erbt ItemDelegate, was bedeutet, dass es aus drei Elementen besteht: einem background, einem contentItem und einem indicator. TreeViewDelegate kümmert sich um indenting das contentItem und den Indikator entsprechend ihrer Position im Baum. Der Indikator ist nur sichtbar, wenn sich das delegierte Element innerhalb des tree column befindet und ein Modellelement with children wiedergibt.

Wenn Sie den Indikator ändern, wird er nicht mehr standardmäßig eingerückt. Stattdessen müssen Sie ihn selbst einrücken, indem Sie den x position des Indikators unter Berücksichtigung von depth und indentation einstellen. Nachstehend finden Sie ein Beispiel für diese Vorgehensweise:

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

Die Position des contentItem wird mit padding gesteuert. Dies bedeutet, dass Sie das contentItem ändern können, ohne sich um die Einrückung zu kümmern. Es bedeutet aber auch, dass Sie es vermeiden sollten, padding in etwas anderes zu ändern, da dadurch die Einrückung entfernt wird. Der Abstand links vom Indikator wird stattdessen mit leftMargin gesteuert. Der Abstand zwischen dem Indikator und dem contentItem wird mit spacing gesteuert. Und der Abstand rechts vom contentItem wird mit rightMargin gesteuert.

Interaktion mit Zeigern

TreeViewDelegate erbt ItemDelegate. Das bedeutet, dass es Signale wie clicked aussendet, wenn der Benutzer auf den Delegaten klickt. Wenn nötig, könnte man eine Verbindung zu diesem Signal herstellen, um anwendungsspezifische Funktionalität zu implementieren, zusätzlich zum standardmäßigen Expandieren/Kollabieren-Verhalten (und sogar pointerNavigationEnabled auf false setzen, um das Standardverhalten ebenfalls zu deaktivieren).

Die API von ItemDelegate gibt Ihnen jedoch keine Informationen über die Position des Klicks oder darüber, welche Modifikatoren gehalten werden. Wenn dies erforderlich ist, wäre es besser, z. B. Pointer-Handler zu verwenden:

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)
            }
        }
    }
}

Bearbeiten von Knoten im Baum

TreeViewDelegate hat einen Standard edit delegate zugewiesen. Wenn TreeView edit triggers gesetzt ist und model Unterstützung für editing model items hat, dann kann der Benutzer einen der Bearbeitungsauslöser aktivieren, um den Text des Baumknotens current zu bearbeiten.

Der Standard-Editierdelegat wird versuchen, Qt.EditRole zu verwenden, um Daten auf model zu lesen und zu schreiben. Wenn QAbstractItemModel::data() einen leeren String für diese Rolle zurückgibt, wird stattdessen Qt.DisplayRole verwendet.

Sie können jederzeit Ihren eigenen benutzerdefinierten Editierdelegaten TableView.editDelegate zuweisen, wenn Sie Bedürfnisse haben, die über das hinausgehen, was der Standard Editierdelegat bietet.

Siehe auch TreeView.

Eigenschaft Dokumentation