ItemDelegate QML 类型

基本项代理,可用于各种视图和控制。 更多...

导入语句import QtQuick.Controls
继承

AbstractButton

由以下类型继承

CheckDelegateRadioDelegateSwipeDelegateSwitchDelegateTreeViewDelegate

属性

详细描述

ItemDelegate 展示标准视图项。它可以作为各种视图和控制中的代理,例如 ListViewComboBox

ItemDelegate 继承其 API 来自 AbstractButton。例如,您可以设置 text、显示一个 图标,并使用 AbstractButton API响应用户的点击。

ListView {
    width: 160
    height: 240

    model: Qt.fontFamilies()

    delegate: ItemDelegate {
        text: modelData
        width: parent.width
        onClicked: console.log("clicked:", modelData)

        required property string modelData
    }

    ScrollIndicator.vertical: ScrollIndicator { }
}

另请参阅自定义 ItemDelegate代理控件

属性文档

highlighted : bool

该属性表示代理是否突出显示。

可以通过突出显示来使代理引起用户的注意。它对键盘交互没有影响。例如,您可以使用以下代码在 ListView 中突出显示当前项

ListView {
    id: listView
    model: 10
    delegate: ItemDelegate {
        text: index
        highlighted: ListView.isCurrentItem

        required property int index

        onClicked: listView.currentIndex = index
    }
}

默认值是 false


© 2024 Qt 公司有限公司。此处包含的文档贡献权属于各自的拥有者。本提供的文档是根据由自由软件基金会发布的GNU 自由文档许可证版本 1.3许可的。Qt 和相应的标志是芬兰的 Qt 公司及其在世界其他国家的商标。所有其他商标均为各自所有者的财产。