Тип QML AbstractButton
Абстрактный базовый тип, предоставляющий функциональность, общую для кнопок. Подробнее...
| Заявление об импорте: | import QtQuick.Controls 2.5 |
| С: | 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.name : строка
- icon.source : url
- icon.width : int
- icon.height : int
- icon.color : цвет
- implicitIndicatorHeight : вещественное
- implicitIndicatorWidth : вещественное
- indicator : Элемент
- 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() при удерживании кнопки.
Значение по умолчанию — 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 : enumeration
Это свойство определяет, как отображаются icon и text внутри кнопки.
| Отображение | Результат |
|---|---|
AbstractButton.IconOnly |
|
AbstractButton.TextOnly |
|
AbstractButton.TextBesideIcon |
|
AbstractButton.TextUnderIcon |
Это свойство было добавлено в QtQuick.Controls 2.3 (Qt 5.10).
down : bool
Это свойство указывает, визуально ли кнопка нажата.
Если не задано явно, это свойство следует значению pressed. Чтобы вернуться к значению по умолчанию, установите это свойство в undefined.
См. также pressed.
icon.name : string
Эта группа свойств была добавлена в QtQuick.Controls 2.3.
| Имя | Описание |
|---|---|
| name | Это свойство содержит имя иконки для использования. Иконка будет загружена из темы платформы. Если иконка найдена в теме, она всегда будет использована; даже если свойство icon.source также установлено. Если иконка не найдена, будет использоваться свойство icon.source. Дополнительную информацию об иконках темы см. в QIcon::fromTheme(). |
| source | Это свойство содержит имя иконки для использования. Иконка будет загружена как обычное изображение. Если свойство icon.name установлено и ссылается на допустимую иконку темы, оно всегда будет использовано вместо этого свойства. |
| width | Это свойство содержит ширину иконки. Ширина иконки никогда не будет превышать этого значения, хотя она будет уменьшаться при необходимости. |
| height | Это свойство содержит высоту иконки. Высота иконки никогда не будет превышать этого значения, хотя она будет уменьшаться при необходимости. |
| color | Это свойство содержит цвет иконки. Иконка тонируется указанным цветом, если цвет не установлен в |
См. также text, display и Иконки в Qt Quick Controls 2.
[только для чтения] 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()
Этот сигнал излучается, когда пользователь интерактивно нажимает и удерживает кнопку с помощью касания или мыши.
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.12/qml-qtquick-controls2-abstractbutton.html