Тип 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 : 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() сигналы при нажатии и удержании кнопки.
Значение по умолчанию — 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.name : строка
Эта группа свойств была добавлена в QtQuick.Controls 2.3.
| Имя | Описание |
|---|---|
| name | Это свойство содержит имя иконки для использования. Иконка будет загружена из темы платформы. Если иконка найдена в теме, она всегда будет использоваться; даже если свойство icon.source также задано. Если иконка не найдена, будет использовано значение icon.source. Дополнительную информацию об иконках темы см. в QIcon::fromTheme(). |
| source | Это свойство содержит имя иконки для использования. Иконка будет загружена как обычное изображение. Если свойство icon.name задано и ссылается на допустимую иконку темы, оно всегда будет использоваться вместо этого свойства. |
| width | Это свойство содержит ширину иконки. Ширина иконки никогда не превысит это значение, хотя она будет уменьшаться при необходимости. |
| height | Это свойство содержит высоту иконки. Высота иконки никогда не превысит это значение, хотя она будет уменьшаться при необходимости. |
| color | Это свойство содержит цвет иконки. Иконка тонируется указанным цветом, если цвет не равен |
| cache | Это свойство указывает, должна ли иконка кэшироваться. Значение по умолчанию — true. |
См. также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.13/qml-qtquick-controls2-abstractbutton.html