Spec-Zone.ru › Qt 5.14

Тип QML AbstractButton

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

Заявление об импорте: import QtQuick.Controls 2.14
С тех пор: Qt 5.7
Наследует:

Control

Наследуется от:

Button, CheckBox, DelayButton, ItemDelegate, MenuBarItem, MenuItem, RadioButton, Switch и TabButton

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

Свойства

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

Сигналы

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

Методы

  • void toggle()

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

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

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

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

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.

autoRepeatDelay : int

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

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

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

autoRepeatInterval : int

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

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

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

checkable : bool

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

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

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

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

См. также checked.

checked : bool

Это свойство хранит значение, определяющее, выбрана ли кнопка.

См. также checkable.

display : перечисление

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

Отображение Результат
AbstractButton.IconOnly

AbstractButton.TextOnly

AbstractButton.TextBesideIcon

AbstractButton.TextUnderIcon

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

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

down : bool

Это свойство хранит значение, определяющее, визуально ли кнопка нажата.

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

См. также pressed.

icon.color : цвет

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

Имя Описание
name Это свойство содержит имя значка, который нужно использовать.

Значок будет загружен из темы платформы. Если значок найден в теме, он всегда будет использоваться; даже если свойство icon.source также задано. Если значок не найден, будет использовано свойство icon.source.

Дополнительную информацию о значках темы см. в QIcon::fromTheme().

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

Значок будет загружен как обычное изображение.

Если свойство icon.name задано и ссылается на допустимый значок темы, оно всегда будет использоваться вместо этого свойства.

width Это свойство содержит ширину значка.

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

height Это свойство содержит высоту значка.

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

color Это свойство содержит цвет значка.

Значок тонируется указанным цветом, если цвет не установлен в "transparent".

cache Это свойство определяет, нужно ли кэшировать значок.

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

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

[только для чтения] implicitIndicatorHeight : real

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

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

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

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

См. также implicitIndicatorWidth.

[только для чтения] implicitIndicatorWidth : real

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

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

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

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

См. также implicitIndicatorHeight.

indicator : Item

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

[только для чтения] pressX : real

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

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

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

См. также pressY.

[только для чтения] pressY : real

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

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

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

См. также pressX.

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

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

См. также down.

text : string

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

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

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

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

canceled()

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

clicked()

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

doubleClicked()

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

pressAndHold()

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

pressed()

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

released()

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

toggled()

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

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

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

void toggle()

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

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.14/qml-qtquick-controls2-abstractbutton.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API