Skip to content
GitLab
Select Git revision
  • 5.12
  • 5.12.12
  • 6.2 default
  • dev
  • 5.15
  • 5.12.11
  • 5.15.2
  • 5.12.10
  • 5.15.1
  • 5.12.9
  • 5.15.0
  • 5.14
  • 5.12.8
  • 5.14.2
  • 5.12.7
  • 5.14.1
  • 5.9
  • 5.14.0
  • 5.12.6
  • 5.13
  • v5.15.0-alpha1
  • v5.12.7
  • v5.14.1
  • v5.9.9
  • v5.14.0
  • v5.14.0-rc2
  • v5.14.0-rc1
  • v5.12.6
  • v5.14.0-beta3
  • v5.13.2
  • v5.14.0-beta2
  • v5.14.0-beta1
  • v5.14.0-alpha1
  • v5.12.5
  • v5.13.1
  • v5.13.0
  • v5.13.0-rc3
  • v5.12.4
  • v5.13.0-rc2
  • v5.13.0-rc1
Find file BlameHistoryPermalink
ComboBox.qml 8.00 KiB
1 
/****************************************************************************
2 
**
3 
** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
4 
** Contact: http://www.qt-project.org/legal
5 
**
6 
** This file is part of the Qt Quick Controls module of the Qt Toolkit.
7 
**
8 
** $QT_BEGIN_LICENSE:BSD$
9 
** You may use this file under the terms of the BSD license as follows:
10 
**
11 
** "Redistribution and use in source and binary forms, with or without
12 
** modification, are permitted provided that the following conditions are
13 
** met:
14 
**   * Redistributions of source code must retain the above copyright
15 
**     notice, this list of conditions and the following disclaimer.
16 
**   * Redistributions in binary form must reproduce the above copyright
17 
**     notice, this list of conditions and the following disclaimer in
18 
**     the documentation and/or other materials provided with the
19 
**     distribution.
20 
**   * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names
21 
**     of its contributors may be used to endorse or promote products derived
22 
**     from this software without specific prior written permission.
23 
**
24 
**
25 
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
26 
** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
27 
** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
28 
** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
29 
** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
30 
** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
31 
** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
32 
** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
33 
** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
34 
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
35 
** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
36 
**
37 
** $QT_END_LICENSE$
38 
**
39 
****************************************************************************/
40
41 
import QtQuick 2.1
42 
import QtQuick.Controls 1.0
43 
import QtQuick.Controls.Private 1.0
44
45 
/*!
46 
    \qmltype ComboBox
47 
    \inqmlmodule QtQuick.Controls 1.0
48 
    \since QtQuick.Controls 1.0
49 
    \ingroup controls
50 
    \brief Provides a drop-down list functionality.
51
52 
    Add items to the comboBox by assigning it a ListModel, or a list of strings to the \l model property.
53
54 
    \qml
55 
       ComboBox {
56 
           width: 200
57 
           model: [ "Banana", "Apple", "Coconut" ]
58 
       }
59 
    \endqml
60
61 
    Example 2:
62
63 
    \qml
64 
       ComboBox {
65 
           model: ListModel {
66 
               id: cbItems
67 
               ListElement { text: "Banana"; color: "Yellow" }
68 
               ListElement { text: "Apple"; color: "Green" }
69 
               ListElement { text: "Coconut"; color: "Brown" }
70 
           }
7172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140
width: 200 onCurrentIndexChanged: console.debug(currentText + ", " + cbItems.get(currentIndex).color) } \endqml You can create a custom appearance for a ComboBox by assigning a \l ComboBoxStyle. */ Control { id: comboBox /*! \qmlproperty model ComboBox::model The model to populate the ComboBox from. */ property alias model: popupItems.model /*! The model role used for populating the ComboBox. */ property string textRole: "" /*! \qmlproperty int ComboBox::currentIndex The index of the currently selected item in the ComboBox. */ property alias currentIndex: popup.__selectedIndex /*! \qmlproperty string ComboBox::currentText The text of the currently selected item in the ComboBox. */ readonly property alias currentText: popup.selectedText /*! This property specifies whether the combobox should gain active focus when pressed. The default value is \c false. */ property bool activeFocusOnPress: false /*! \qmlproperty bool ComboBox::pressed This property holds whether the button is being pressed. */ readonly property bool pressed: mouseArea.pressed && mouseArea.containsMouse || popup.__popupVisible /*! \qmlproperty bool ComboBox::hovered This property indicates whether the control is being hovered. */ readonly property alias hovered: mouseArea.containsMouse /*! \internal */ property var __popup: popup style: Qt.createComponent(Settings.style + "/ComboBoxStyle.qml", comboBox) activeFocusOnTab: true Accessible.role: Accessible.ComboBox MouseArea { id: mouseArea anchors.fill: parent hoverEnabled: true onPressed: { if (comboBox.activeFocusOnPress) forceActiveFocus() popup.show() } } Component.onCompleted: { if (currentIndex === -1) currentIndex = 0 popup.ready = true popup.resolveTextValue(textRole) }
141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210
onTextRoleChanged: popup.resolveTextValue(textRole) Menu { id: popup objectName: "popup" style: isPopup ? __style.__popupStyle : __style.__dropDownStyle readonly property string selectedText: items[__selectedIndex] ? items[__selectedIndex].text : "" property string textRole: "" property bool ready: false property bool isPopup: __panel ? __panel.popup : false property int y: isPopup ? (comboBox.__panel.height - comboBox.__panel.implicitHeight) / 2.0 : comboBox.__panel.height __minimumWidth: comboBox.width __visualItem: comboBox property ExclusiveGroup eg: ExclusiveGroup { id: eg } property bool __modelIsArray: popupItems.model ? popupItems.model.constructor === Array : false Instantiator { id: popupItems active: false MenuItem { text: popup.textRole === '' ? modelData : ((popup.__modelIsArray ? modelData[popup.textRole] : model[popup.textRole]) || '') checkable: true exclusiveGroup: eg } onObjectAdded: popup.insertItem(index, object) onObjectRemoved: popup.removeItem(object) } function resolveTextValue(initialTextRole) { if (!ready || !model) { popupItems.active = false return; } var get = model['get']; if (!get && popup.__modelIsArray) { if (model[0].constructor !== String) // arrays of strings don't have textRole get = function(i) { return model[i]; } } var modelMayHaveRoles = get !== undefined textRole = initialTextRole if (textRole === "" && modelMayHaveRoles && get(0)) { // No text role set, check whether model has a suitable role // If 'text' is found, or there's only one role, pick that. var listElement = get(0) var roleName = "" var roleCount = 0 for (var role in listElement) { if (role === "text") { roleName = role break } else if (!roleName) { roleName = role } ++roleCount } if (roleCount > 1 && roleName !== "text") { console.warn("No suitable 'textRole' found for ComboBox.") } else {