qml ComboBox 组合框

最新推荐文章于 2025-10-13 01:34:27 发布

原创

最新推荐文章于 2025-10-13 01:34:27 发布 · 1.1k 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#前端 #开发语言

ComboBox 组合框

在QML（Qt Meta Language）中，ComboBox是一种常用的用户界面元素，
用于让用户从一组预定义的选项中选择一个。

ComboBox通常由一个文本输入框和一个下拉列表组成，

用户可以点击文本输入框来展开下拉列表，然后从中选择一个选项。

属性:

model:

类型: var
描述: 定义ComboBox的选项列表。可以是数组、ListModel或其他可迭代的数据源。
示例:
ComboBox {
    model: ["Option 1", "Option 2", "Option 3"]
}

currentIndex:

类型: int
描述: 当前选中的选项的索引。
示例:
ComboBox {
    model: ["Option 1", "Option 2", "Option 3"]
    currentIndex: 1  // 默认选中第二个选项
}

currentText:

类型: string
描述: 当前选中的选项的文本。
示例:
ComboBox {
    model: ["Option 1", "Option 2", "Option 3"]
    onCurrentTextChanged: console.log("Current text:", currentText)
}

editable:

类型: bool
描述: 是否允许用户编辑文本输入框。
示例:
ComboBox {
    model: ["Option 1", "Option 2", "Option 3"]
    editable: true
}

textRole:

类型: string
描述: 当模型是一个对象列表时，指定显示在ComboBox中的文本属性。
示例:
ListModel {
    id: comboModel
    ListElement { name: "Option 1"; value: 1 }
    ListElement { name: "Option 2"; value: 2 }
}
ComboBox {
    model: comboModel
    textRole: "name"
}

displayText:

类型: string
描述: 显示在ComboBox输入框中的文本。可以用于自定义显示文本。
示例:
ComboBox {
    model: ["Option 1", "Option 2", "Option 3"]
    displayText: "Select an option"
}

count:

类型: int
描述: ComboBox中选项的总数。
示例:
ComboBox {
    model: ["Option 1", "Option 2", "Option 3"]
    onCountChanged: console.log("