QML类型说明-ComboBox

ComboBox

 

ImportStatement:   import QtQuick.Controls 1.2

Since:  Qt 5.1

Inherits:      FocusScope

 

Properties

acceptableInput: bool

activeFocusOnPress: bool

count : int

currentIndex: int

currentText: string

editText :string

editable :bool

hovered : bool

model :model

pressed :bool

style :Component

textRole :string

validator :Validator

 

Signals

accepted()

activated(intindex)

Methods

find(text)

selectAll()

textAt(index)

 

DetailedDescription

可以分配给下拉选择框一个ListModel或模板属性的字符串列表。

ComboBox {

    width: 200

    model: [ "Banana","Apple", "Coconut" ]

}

下面的例子演示了如何使用ListModel。

ComboBox {

    currentIndex: 2

    model: ListModel {

        id: cbItems

        ListElement { text: "Banana";color: "Yellow" }

        ListElement { text: "Apple";color: "Green" }

        ListElement { text:"Coconut"; color: "Brown" }

    }

    width: 200

    onCurrentIndexChanged:console.debug(cbItems.get(currentIndex).text + ", " +cbItems.get(currentIndex).color)

}

我们可以通过editable属性让下拉选择框变成可编辑的。一个可编辑的下拉选择框可自动基于可利用的模板完成文本。

下面的例子演示了通过onAccepted信号添加模板中的项。注意我们必须显式的防止重复。

另外注意下面的例子，我们人工给模板添加了内容，更多的时候，我们只是使用下拉选择框的可编辑功能，用来在下拉选择框中获得对应项。

ComboBox {

     editable: true

     model: ListModel {

         id: model

         ListElement { text:"Banana"; color: "Yellow" }

         ListElement { text: "Apple";color: "Green" }

         ListElement { text:"Coconut"; color: "Brown" }

     }

     onAccepted: {

         if (editableCombo.find(currentText)=== -1) {

             model.append({text: editText})

             currentIndex =editableCombo.find(editText)

         }

     }

 }

我们可以通过ComboBoxStyle创建ComboBox的样式。

 

PropertyDocumentation

acceptableInput: bool

这是只读的，如果组合框包含可编辑的文本框中的文本，则为真。如果验证器被设置，如果当前文本满足验证器或匹配最终的文本（不是中间的一段字符），则返回真。

这个QML属性在QtQuick.Controls 1.1被介绍。同时参阅validator和accepted。

 

activeFocusOnPress: bool

指明下拉选择框是否在按下的时候获得活跃的焦点。默认为假。

 

count : int

只读的，下拉选择框中组件的数目。这个QML属性在QtQuick.Controls 1.1中被介绍。

 

currentIndex: int

下拉选择框当前选择的组件的索引。设置它为-1将重置selection和清空文本标签。如果下拉选择框是可编辑的，我们还需要人工清除editText。

 

currentText: string

只读的，在下拉选择框当前选中组件的文本。注意currentText依赖于currentIndex，没有办法确认当onCurrentIndexChanged被调用时，currentText被更新。

 

editText :string

在可编辑的下拉选择框中被用户操作的编辑框。这个QML属性在QtQuick.Controls 1.1中被介绍。

 

editable :bool

下拉选择框是否可被用户编辑，默认为假，这个QML属性在QtQuick.Controls 1.1中被介绍。

 

hovered :bool

只读的，控制是否悬停在下拉选择框。

 

model :model

填充下拉选择框的模板，在下拉选择框初始化后改变模板，将重置currentIndex为0。

 

pressed :bool

只读的，按纽是否被按下。

 

style :Component

这个组件的样式。

 

textRole :string

用来填充下拉选择框的模板的功能。

 

validator :Validator

允许我们在可编辑的下拉选择框设置文本验证器。当设置了验证器，只有当enter被按下时，文本处于可接受状态，accepted信号才会发射。当前支持的验证器为IntValidator、DoubleValidator和RegExpValidator。下面展示了使用验证器的例子，它允许在文档域输入0到10的整数（英文文档是11到31，看代码是0到10）。只有当editable为真时，这个属性才是有用效的。

importQtQuick 2.2

importQtQuick.Controls 1.2

 

ComboBox {

    editable: true

    model: 10

    validator: IntValidator {bottom: 0; top:10;}

    focus: true

}

这个QML属性在QtQuick.Controls 1.1中被介绍。

 

SignalDocumentation

accepted()

在可编辑的下拉选择框中，当Enter键被按下，这个信号被发射。如果确认的文档不在当前的模板中，currentIndex被设置成-1，currentText被更新为确认文档。

注意：如果验证器被设置，只有当文本域为可接受状态，这个信号才被发射。

这个QML信号在QtQuick.Controls 1.1中被介绍。

 

activated(intindex)

index是新字符被接受时，在模板的索引或-1。

这个信号和currentIndex的改变相似，但它仅仅在用户改变下拉选择框时发射。这意味着应用程序改变下拉选择框不发射该信号。这个QML信号在QtQuick.Controls 1.1中被介绍。

 

MethodDocumentation

find( text)

寻找或返回给定文档的索引，如果匹配者没有发现，返回-1。搜索区分大小写。

 

selectAll()

所有的编辑文本被选择。

 

textAt(index)

返回给定索引的文本。如果无效的索引被提供，则返回空。