Тип QML AbstractButton
Абстрактный базовый тип, предоставляющий функциональность, общую для кнопок. Подробнее...
| Заявление об импорте: | import QtQuick.Controls 2.15 |
| С момента: | Qt 5.7 |
| Наследует: | |
| Наследуется от: | Кнопка, 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.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 и Кнопки.
Документация по свойствам
action : Action
Это свойство содержит действие кнопки.
Это свойство было добавлено в QtQuick.Controls 2.3 (Qt 5.10).
См. также Действие.
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.cache : bool
Эта группа свойств была добавлена в QtQuick.Controls 2.3.
| Имя | Описание |
|---|---|
| name | Это свойство содержит имя значка для использования. Значок будет загружен из темы платформы. Если значок найден в теме, он всегда будет использоваться; даже если icon.source также задан. Если значок не найден, icon.source будет использован вместо него. Дополнительную информацию о значках темы см. в QIcon::fromTheme(). |
| source | Это свойство содержит имя значка для использования. Значок будет загружен как обычное изображение. Если icon.name задан и ссылается на допустимый значок темы, он всегда будет использован вместо этого свойства. |
| width | Это свойство содержит ширину значка. Ширина значка никогда не превысит это значение, хотя она будет уменьшаться при необходимости. |
| height | Это свойство содержит высоту значка. Высота значка никогда не превысит это значение, хотя она будет уменьшаться при необходимости. |
| color | Это свойство содержит цвет значка. Значок тонируется указанным цветом, если цвет не установлен в |
| cache | Это свойство указывает, должен ли значок кэшироваться. Значение по умолчанию — true. Это свойство было добавлено в QtQuick.Controls 2.13. |
См. также 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, но курсор мыши не находится внутри кнопки.
Примечание: Соответствующий обработчик — onCanceled.
clicked()
Этот сигнал испускается, когда пользователь нажимает кнопку интерактивно с помощью касания, мыши или клавиатуры.
Примечание: Соответствующий обработчик — onClicked.
doubleClicked()
Этот сигнал испускается, когда пользователь дважды нажимает кнопку интерактивно с помощью касания или мыши.
Примечание: Соответствующий обработчик — onDoubleClicked.
pressAndHold()
Этот сигнал испускается, когда пользователь интерактивно нажимает и удерживает кнопку с помощью касания или мыши. Он не испускается, когда autoRepeat включен.
Примечание: Соответствующий обработчик — onPressAndHold.
pressed()
Этот сигнал испускается, когда пользователь интерактивно нажимает кнопку с помощью касания, мыши или клавиатуры.
Примечание: Соответствующий обработчик — onPressed.
released()
Этот сигнал испускается, когда пользователь интерактивно отпускает кнопку с помощью касания, мыши или клавиатуры.
Примечание: Соответствующий обработчик — onReleased.
toggled()
Этот сигнал испускается, когда пользователь интерактивно переключает состояние переключаемой кнопки с помощью касания, мыши или клавиатуры.
Примечание: Соответствующий обработчик — onToggled.
Этот сигнал был добавлен в 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.15/qml-qtquick-controls2-abstractbutton.html