QML-тип Button

Кнопка с текстовой меткой. Подробнее...

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

Свойства

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

Тип Button реализует оформленную в стиле ОС Аврора кнопку с текстовой меткой.

Ниже приведен пример кода, который реализует простую кнопку:

 import QtQuick 2.2
 import Sailfish.Silica 1.0

 Button {
    text: "click me"
    onClicked: console.log("clicked!")
 }

Button наследуется от типа QtQuick MouseArea. Поэтому свойства, сигналы и методы MouseArea (например, onClicked в примере выше) также доступны для объектов Button. Полный список доступных свойств, сигналов и методов приведен в документации MouseArea.

При назначении ширины кнопки рекомендуется вместо свойства width использовать свойство preferredWidth. Это позволит автоматически увеличить размер кнопки для вмещения текста.

Если для объекта типа Button установлено значение высоты, то визуально кнопка сохраняет размер, увеличивается лишь область нажатия.

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

color : color

С помощью свойства color задается цвет кнопки и размещенного на ней текста.

См. также highlightBackgroundColor и highlightColor.

down : bool

Истинно, пока кнопка нажата, и положение касания остается в области этой кнопки.

См. также MouseArea::pressed.

highlightBackgroundColor : color

При истинном значении свойства down цвет кнопки задается с помощью свойства highlightBackgroundColor.

См. также highlightColor и color.

highlightColor : color

При истинном значении свойства down цвет текста кнопки задается с помощью свойства highlightColor.

См. также highlightBackgroundColor и color.

preferredWidth : real

Содержит размер кнопки. Данное свойство может принимать следующие значения:

  • Theme.buttonWidthExtraSmall — значение ширины самой маленькой кнопки в интерфейсе ОС Аврора, которое используется только в случае плотной компоновки кнопок. На экране с портретной ориентацией могут быть размещены три такие кнопки. В большинстве приложений следует избегать использования данного варианта.
  • Theme.buttonWidthSmall — значение ширины маленькой кнопки, которое используется по умолчанию. Данное значение подобрано так, что на экране с портретной ориентацией могут быть размещены две такие кнопки. На больших экранах или на экранах с альбомной ориентацией может быть размещено больше двух маленьких кнопок.
  • Theme.buttonWidthMedium — значение ширины средней кнопки. На экране (в зависимости от его размера и ориентации), как правило, может быть размещена только одна средняя кнопка.
  • Theme.buttonWidthLarge — значение ширины большой кнопки. На экране (в зависимости от его размера и ориентации), как правило, может быть размещена только одна большая кнопка.

В случае, если заданный текст не вмещается в указанный размер кнопки, ее ширина будет автоматически увеличена, чтобы вместить текст.

text : string

Содержит отображаемый на кнопке текст.