QML-тип ComboBox

Элемент графического интерфейса для выбора варианта из выпадающего списка. Подробнее…

Строка импорта:	`import Sailfish.Silica 1.0`
Наследуется от:	ValueButton

Список всех членов класса, включая унаследованные

Свойства

currentIndex : int
currentItem : Item
description : string
label : string
menu : Item
value : string

Подробное описание

Тип ComboBox предоставляет текстовую метку с прикрепленным меню, чтобы пользователь мог выбрать значение из выпадающего списка.

Выпадающий список отображает рядом метку (свойство label) и значение (свойство value). При нажатии на метку или значение появляется контекстное меню со списком доступных вариантов для выбора. Контекстное меню можно задавать как содержимое свойства menu.

Ниже приведён пример простого выпадающего списка:

import QtQuick 2.2
import Sailfish.Silica 1.0

ComboBox {
    width: 480
    label: "Яркость экрана"

    menu: ContextMenu {
        MenuItem { text: "автоматически" }
        MenuItem { text: "вручную" }
        MenuItem { text: "высокая" }
    }
}

Текстовая метка "Screen brightness:" отображается рядом со значением "automatic". При нажатии на текстовой метке или значении появляется меню, описанное в свойстве menu. При этом выбранный пункт меню подсвечивается. При нажатии на пункт меню само меню закрывается, а значение свойства value будет заменено на выбранный пункт меню.

По умолчанию значением свойства value является текущий выбранный пункт меню. В примере выше таковым является первый элемент списка, поскольку значения свойств currentIndex и currentItem не были указаны.

См. также BackgroundItem.

Описание свойств

currentIndex : int

Индекс выбранного в настоящий момент пункта меню, заданного в свойстве menu. По умолчанию равен 0.

Изменение значения этого свойства автоматически обновляет значение свойства currentItem, которое ссылается на пункт меню по заданному индексу. Если для индекса установить недопустимое значение (вне диапазона допустимых значений для списка в свойстве menu), то это приведет к тому, что вы выпадающем списке выбранный пункт меню будет очищен (значению свойства value будет присвоена пустая строка), значение свойства currentIndex будет установлено в -1, а значение свойства currentItem — в null.

Если изначально задаются оба свойства currentIndex и currentItem, приоритет отдается значению currentItem.

См. также currentItem.

currentItem : Item

Выбранный в настоящий момент пункт контекстного меню. Если для свойства currentIndex задать допустимое значение, то по умолчанию будет использоваться элемент (пункт контекстного меню), соответствующий значению индекса. В противном случае значением по умолчанию для пункта контекстного меню будет null.

Изменение значения данного свойства автоматически обновляет значение свойства currentIndex. Установка данного свойства в значение null либо установка false для значения enabled очистит текущее выделение, присвоением свойству currentItem значения null, а свойству currentIndex значения -1.

Если изначально задаются оба свойства currentIndex и currentItem, приоритет отдаётся значению currentItem.

См. также currentIndex.

description : string

Необязательный текст для описания назначения выпадающего списка.

label : string

Краткое описание возможных значений для пунктов контекстного меню.

См. также value.

menu : Item

Контекстное меню, которое отображается при нажатии на метку (свойство label) или значение (свойство value).

value : string

Текст выбранного в настоящий момент пункта контекстного меню, определённого свойствами currentIndex или currentItem.

См. также label.