Тип QML AbstractButton

Абстрактный базовый тип, предоставляющий функциональность, общую для кнопок. Подробнее...

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

Свойства

• action : Действие
• autoExclusive : bool
• autoRepeat : bool
• autoRepeatDelay : int
• autoRepeatInterval : int
• checkable : bool
• checked : bool
• display : перечисление
• down : bool
• icon
  • icon.cache : bool
  • icon.color : цвет
  • icon.height : int
  • icon.name : строка
  • icon.source : url
  • icon.width : int
• implicitIndicatorHeight : real
• implicitIndicatorWidth : real
• indicator : Элемент
• pressX : real
• pressY : real
• pressed : bool
• text : строка

Сигналы

• canceled()
• clicked()
• doubleClicked()
• pressAndHold()
• pressed()
• released()
• toggled()

Методы

• void toggle()

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

AbstractButton предоставляет интерфейс для элементов управления с поведением, подобным кнопкам; например, кнопок и элементов управления, которые можно выбирать, таких как радиокнопки и флажки. Как абстрактный элемент управления, он не имеет реализаций делегата, оставляя их типам, которые наследуют от него.

См. также ButtonGroup и Элементы управления кнопками.

Документация по свойствам

[с момента QtQuick.Controls 2.3 (Qt 5.10)] action : Action

Это свойство содержит действие кнопки.

Это свойство было добавлено в QtQuick.Controls 2.3 (Qt 5.10).

См. также Action.

autoExclusive : bool

Это свойство указывает, включена ли автоматическая взаимоисключительность.

Если автоматическая взаимоисключительность включена, элементы управления кнопками, которые принадлежат одному и тому же родительскому элементу, ведут себя так, как будто они являются частью одной и той же ButtonGroup. Одновременно может быть выбрана только одна кнопка; выбор другой кнопки автоматически снимает выбор ранее выбранной.

Примечание: Свойство не влияет на кнопки, которые принадлежат ButtonGroup.

RadioButton и TabButton по умолчанию взаимоисключают друг друга.

autoRepeat : bool

Это свойство указывает, повторяются ли pressed(), released() и clicked() сигналы, пока кнопка удерживается нажатой.

Если это свойство установлено в true, сигнал pressAndHold() не будет выпущен.

Значение по умолчанию - false.

Задержка инициализации и интервал повторения определяются в миллисекундах свойствами autoRepeatDelay и autoRepeatInterval.

[с момента QtQuick.Controls 2.4 (Qt 5.11)] autoRepeatDelay : int

Это свойство содержит начальную задержку автоматического повторения в миллисекундах. Значение по умолчанию - 300 мс.

Это свойство было добавлено в QtQuick.Controls 2.4 (Qt 5.11).

См. также autoRepeat и autoRepeatInterval.

[с момента QtQuick.Controls 2.4 (Qt 5.11)] autoRepeatInterval : int

Это свойство содержит интервал автоматического повторения в миллисекундах. Значение по умолчанию - 100 мс.

Это свойство было добавлено в QtQuick.Controls 2.4 (Qt 5.11).

См. также autoRepeat и autoRepeatDelay.

checkable : bool

Это свойство указывает, можно ли выбрать кнопку.

Кнопка, которую можно выбирать, переключается между состояниями выбранной (включенной) и невыбранной (выключенной), когда пользователь нажимает на нее или нажимает клавишу пробела, когда у кнопки есть активный фокус.

Установка checked в true принудительно устанавливает это свойство в true.

Значение по умолчанию - false.

См. также checked.

checked : bool

Это свойство указывает, выбрана ли кнопка.

См. также checkable.

[с момента QtQuick.Controls 2.3 (Qt 5.10)] display : enumeration

Это свойство определяет, как отображаются icon и text внутри кнопки.

Это свойство было добавлено в QtQuick.Controls 2.3 (Qt 5.10).

См. также spacing и padding.

down : bool

Это свойство указывает, визуально ли кнопка нажата.

Если явно не установлено, это свойство следует значению pressed. Чтобы вернуться к значению по умолчанию, установите это свойство в undefined.

См. также pressed.

icon.cache : bool

Эта группа свойств была добавлена в QtQuick.Controls 2.3.

См. также text, display и Иконки в Qt Quick Controls.

[только для чтения, начиная с QtQuick.Controls 2.5 (Qt 5.12)] implicitIndicatorHeight : real

Это свойство содержит неявную высоту индикатора.

Значение равно indicator ? indicator.implicitHeight : 0.

Обычно используется вместе с implicitContentHeight и implicitBackgroundHeight для вычисления implicitHeight.

Это свойство было представлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также implicitIndicatorWidth.

[только для чтения, начиная с QtQuick.Controls 2.5 (Qt 5.12)] implicitIndicatorWidth : real

Это свойство содержит неявную ширину индикатора.

Значение равно indicator ? indicator.implicitWidth : 0.

Обычно используется вместе с implicitContentWidth и implicitBackgroundWidth для вычисления implicitWidth.

Это свойство было представлено в QtQuick.Controls 2.5 (Qt 5.12).

См. также implicitIndicatorHeight.

indicator : Item

Это свойство содержит элемент индикатора.

[только для чтения, начиная с QtQuick.Controls 2.4 (Qt 5.11)] pressX : real

Это свойство содержит координату x последнего нажатия.

Примечание: Значение обновляется при перемещении касания, но сохраняется после отпускания касания.

Это свойство было представлено в QtQuick.Controls 2.4 (Qt 5.11).

См. также pressY.

[только для чтения, начиная с QtQuick.Controls 2.4 (Qt 5.11)] pressY : real

Это свойство содержит координату y последнего нажатия.

Примечание: Значение обновляется при перемещении касания, но сохраняется после отпускания касания.

Это свойство было представлено в QtQuick.Controls 2.4 (Qt 5.11).

См. также pressX.

[только для чтения] pressed : bool

Это свойство указывает, нажата ли кнопка физически. Кнопка может быть нажата с помощью касания или событий клавиатуры.

См. также down.

text : string

Это свойство содержит текстовое описание кнопки.

Примечание: Текст используется для целей доступности, поэтому имеет смысл устанавливать текстовое описание, даже если элемент содержимого является изображением.

См. также icon, display и contentItem.

Документация по сигналам

canceled()

Этот сигнал генерируется, когда кнопка теряет захват мыши при нажатии или когда она должна была бы сгенерировать сигнал released, но курсор мыши не находится внутри кнопки.

Примечание: Соответствующий обработчик — onCanceled.

clicked()

Этот сигнал генерируется, когда кнопка нажимается пользователем с помощью касания, мыши или клавиатуры.

Примечание: Соответствующий обработчик — onClicked.

doubleClicked()

Этот сигнал генерируется, когда кнопка дважды нажимается пользователем с помощью касания или мыши.

Примечание: Соответствующий обработчик — onDoubleClicked.

pressAndHold()

Этот сигнал генерируется, когда кнопка нажимается и удерживается пользователем с помощью касания или мыши. Он не генерируется, когда autoRepeat включен.

Примечание: Соответствующий обработчик — onPressAndHold.

pressed()

Этот сигнал генерируется, когда кнопка нажимается пользователем с помощью касания, мыши или клавиатуры.

Примечание: Соответствующий обработчик — onPressed.

released()

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

Примечание: Соответствующий обработчик — onReleased.

[since QtQuick.Controls 2.2 (Qt 5.9)] toggled()

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

Примечание: Соответствующий обработчик — onToggled.

Этот сигнал был представлен в QtQuick.Controls 2.2 (Qt 5.9).

Документация по методам

void toggle()

Переключает состояние проверки кнопки.