Тип QML AbstractButton

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

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

Свойства

• action : 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 и Элементы управления кнопками.

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

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

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