Тип 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 : вещественное число
• implicitIndicatorWidth : вещественное число
• indicator : Элемент
• pressX : вещественное число
• pressY : вещественное число
• pressed : bool
• text : строка

Сигналы

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

Методы

• void toggle()

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

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

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

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

[since QtQuick.Controls 2.3 (Qt 5.10)] action : Action

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

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

См. также Action.

autoExclusive : bool

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

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

RadioButton и TabButton по умолчанию являются взаимоисключающими.

autoRepeat : bool

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

Если это свойство установлено в true, сигнал pressAndHold() не будет генерироваться.

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

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

[since QtQuick.Controls 2.4 (Qt 5.11)] autoRepeatDelay : int

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

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

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

[since QtQuick.Controls 2.4 (Qt 5.11)] autoRepeatInterval : int

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

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

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

checkable : bool

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

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

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

См. также checked.

checked : bool

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

Начиная с Qt 6.2, установка этого свойства больше не влияет на свойство checkable. Если необходимо, явно установите свойство checkable.

См. также checkable.

[since 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()

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