AbstractButton QML Type
Abstract base type providing functionality common to buttons. More...
|Import Statement:||import QtQuick.Controls 2.3|
- action : Action
- autoExclusive : bool
- checkable : bool
- checked : bool
- display : enumeration
- down : bool
- indicator : Item
- pressed : bool
- text : string
- void canceled()
- void clicked()
- void doubleClicked()
- void pressAndHold()
- void pressed()
- void released()
- void toggled()
- void toggle()
AbstractButton provides the interface for controls with button-like behavior; for example, push buttons and checkable controls like radio buttons and check boxes. As an abstract control, it has no delegate implementations, leaving them to the types that derive from it.
action : Action
This property holds the button action.
This QML property was introduced in QtQuick.Controls 2.3 (Qt 5.10).
See also Action.
This property holds whether auto-exclusivity is enabled.
If auto-exclusivity is enabled, checkable buttons that belong to the same parent item behave as if they were part of the same ButtonGroup. Only one button can be checked at any time; checking another button automatically unchecks the previously checked one.
Note: The property has no effect on buttons that belong to a ButtonGroup.
This property holds whether the button is checkable.
A checkable button toggles between checked (on) and unchecked (off) when the user clicks on it or presses the space bar while the button has active focus.
Setting checked to
true forces this property to
The default value is
See also checked.
This property holds whether the button is checked.
See also checkable.
icon.source : url
This property group was added in QtQuick.Controls 2.3.
|name||This property holds the name of the icon to use.|
The icon will be loaded from the platform theme. If the icon is found in the theme, it will always be used; even if icon.source is also set. If the icon is not found, icon.source will be used instead.
For more information on theme icons, see QIcon::fromTheme().
|source||This property holds the name of the icon to use.|
The icon will be loaded as a regular image.
If icon.name is set and refers to a valid theme icon, it will always be used instead of this property.
|width||This property holds the width of the icon.|
The icon's width will never exceed this value, though it will shrink when necessary.
|height||This property holds the height of the icon.|
The icon's height will never exceed this value, though it will shrink when necessary.
|color||This property holds the color of the icon.|
The icon is tinted with the specified color, unless the color is set to
indicator : Item
This property holds the indicator item.
This property holds whether the button is physically pressed. A button can be pressed by either touch or key events.
See also down.
This signal is emitted when the button loses mouse grab while being pressed, or when it would emit the released signal but the mouse cursor is not inside the button.
This signal is emitted when the button is interactively clicked by the user via touch, mouse, or keyboard.
This signal is emitted when the button is interactively double clicked by the user via touch or mouse.
This signal is emitted when the button is interactively pressed and held down by the user via touch or mouse.
This signal is emitted when the button is interactively pressed by the user via touch, mouse, or keyboard.
This signal is emitted when the button is interactively released by the user via touch, mouse, or keyboard.
This signal is emitted when a checkable button is interactively toggled by the user via touch, mouse, or keyboard.
This QML signal was introduced in QtQuick.Controls 2.2 (Qt 5.9).
© 2018 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.