Тип QML AbstractButton
Абстрактный базовый тип, обеспечивающий функциональность, общую для кнопок. Подробнее...
| Заявление об импорте: | import QtQuick.Controls 2.14 |
| С тех пор: | Qt 5.7 |
| Наследует: | |
| Наследуется от: | 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).
down : bool
Это свойство хранит значение, определяющее, визуально ли кнопка нажата.
Если явно не задано, это свойство соответствует значению pressed. Для возврата к значению по умолчанию установите это свойство в undefined.
См. также pressed.
icon.color : цвет
Эта группа свойств была добавлена в QtQuick.Controls 2.3.
| Имя | Описание |
|---|---|
| name | Это свойство содержит имя значка, который нужно использовать. Значок будет загружен из темы платформы. Если значок найден в теме, он всегда будет использоваться; даже если свойство icon.source также задано. Если значок не найден, будет использовано свойство icon.source. Дополнительную информацию о значках темы см. в QIcon::fromTheme(). |
| source | Это свойство содержит имя значка, который нужно использовать. Значок будет загружен как обычное изображение. Если свойство icon.name задано и ссылается на допустимый значок темы, оно всегда будет использоваться вместо этого свойства. |
| width | Это свойство содержит ширину значка. Ширина значка никогда не превысит этого значения, хотя она может уменьшаться при необходимости. |
| height | Это свойство содержит высоту значка. Высота значка никогда не превысит этого значения, хотя она может уменьшаться при необходимости. |
| color | Это свойство содержит цвет значка. Значок тонируется указанным цветом, если цвет не установлен в |
| 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