AbstractButton QML 类型

提供通用功能的基础类型按钮。更多信息...

导入语句	import QtQuick.Controls
继承	Control
由以下类继承	Button、CheckBox、DelayButton、ItemDelegate、MenuBarItem、MenuItem、RadioButton、Switch和TabButton

包括继承成员在内的所有成员列表

属性

action : Action (自 QtQuick.Controls 2.3 (Qt 5.10))
autoExclusive : bool
autoRepeat : bool
autoRepeatDelay : int (自 QtQuick.Controls 2.4 (Qt 5.11))
autoRepeatInterval : int (自 QtQuick.Controls 2.4 (Qt 5.11))
checkable : bool
checked : bool
display : enumeration (自 QtQuick.Controls 2.3 (Qt 5.10))
down : bool
图标
- icon.cache : bool
- icon.color : color
- icon.height : int
- icon.name : string
- icon.source : url
- icon.width : int
implicitIndicatorHeight : real (自 QtQuick.Controls 2.5 (Qt 5.12))
implicitIndicatorWidth : real (自 QtQuick.Controls 2.5 (Qt 5.12))
indicator : Item
pressX : real (自 QtQuick.Controls 2.4 (Qt 5.11))
pressY : real (自 QtQuick.Controls 2.4 (Qt 5.11))
pressed : bool
text : string

信号

已取消()
点击()
双击()
按下并保持()
按下()
释放()
toggled() (自 QtQuick.Controls 2.2 (Qt 5.9))

方法

void toggle()

详细说明

AbstractButton 为类似按钮行为的控件提供接口；例如，推送按钮和可复选控件（如单选按钮和复选框）。作为一个抽象控件，它没有任何代理实现，将其留给从中派生的类型。

另请参阅ButtonGroup 和按钮控件。

属性文档

action : Action [since QtQuick.Controls 2.3 (Qt 5.10)]

此属性包含按钮动作。

此属性自 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 [since QtQuick.Controls 2.4 (Qt 5.11)]

此属性包含自动重复的初始延迟（毫秒）。默认值是 300 ms。

此属性自 QtQuick.Controls 2.4 (Qt 5.11) 被引入。

另请参阅autoRepeat 和 autoRepeatInterval。

autoRepeatInterval : int [since QtQuick.Controls 2.4 (Qt 5.11)]

此属性包含自动重复的间隔（毫秒）。默认值是 100 ms。

此属性自 QtQuick.Controls 2.4 (Qt 5.11) 被引入。

另请参阅autoRepeat 和 autoRepeatDelay。

checkable : bool

此属性指示按钮是否可复选。

当用户点击它或当按钮处于活动焦点时按下空格键时，可复选按钮在选中（开启）和未选中（关闭）之间切换。

默认值是 false。

另请参阅checked。

checked : bool

此属性表示按钮是否被选中。

自Qt 6.2以来，设置此属性不再影响 checkable 属性。如有需要，显式设置 checkable 属性。

另请参阅 checkable。

display : 枚举 [自QtQuick.Controls 2.3 (Qt 5.10)开始]

此属性确定如何在内按钮中显示图标和文本。

显示	结果
`AbstractButton.IconOnly`
`AbstractButton.TextOnly`
`AbstractButton.TextBesideIcon` (默认)
`AbstractButton.TextUnderIcon`

此属性自 QtQuick.Controls 2.3 (Qt 5.10) 被引入。

另请参阅 间距和填充。

down : 布尔值

此属性表示按钮是否视觉上处于按下状态。

除非显式设置，否则此属性将跟随 pressed 的值。要将属性设置回默认值，请将此属性设置为 undefined。

另请参阅 pressed。

图标组
icon.cache : 布尔值
icon.color : 颜色
icon.height : 整数
icon.name : 字符串
icon.source : URL
icon.width : 整数

该属性组自QtQuick.Controls 2.3添加。

名称	描述
name	此属性表示要使用的图标的名称。图标将从平台主题中加载。如果图标配制在主题中，则始终使用它；即使 icon.source 也已设置。如果找不到图标，则使用 icon.source。有关主题图标的更多信息，请参阅 QIcon::fromTheme。
source	此属性表示要使用的图标的名称。图标将以常规图片的形式加载。如果 icon.name 已设置并引用有效的主题图标，则始终使用此属性，而不是此属性。
width	此属性表示图标的宽度。图标的宽度永远不会超过此值，尽管在必要时它会缩小。
height	此属性表示图标的宽度。图标的宽度永远不会超过此值，尽管在必要时它会缩小。
color	此属性表示图标的颜色。除非颜色设置为 `"transparent"`，否则图标将以指定颜色着色。
cache	此属性指定是否缓存图标。默认值是 true。有关更多信息，请参阅 cache。此属性自QtQuick.Controls 2.13引入。

另请参阅 text、display 和 Qt Quick Controls中的图标。

implicitIndicatorHeight : real [只读, 自 QtQuick.Controls 2.5 (Qt 5.12) 开始]

此属性存储隐式指示器的高度。

该值等于 indicator ? indicator.implicitHeight : 0。

通常，与其一起使用 implicitContentHeight 和 implicitBackgroundHeight 来计算 implicitHeight。

此属性在 QtQuick.Controls 2.5 (Qt 5.12) 中引入。

另请参阅implicitIndicatorWidth。

implicitIndicatorWidth : real [只读, 自 QtQuick.Controls 2.5 (Qt 5.12) 开始]

此属性存储隐式指示器的宽度。

该值等于 indicator ? indicator.implicitWidth : 0。

通常，与其一起使用 implicitContentWidth 和 implicitBackgroundWidth 来计算 implicitWidth。

此属性在 QtQuick.Controls 2.5 (Qt 5.12) 中引入。

另请参阅implicitIndicatorHeight。

indicator : Item

此属性存储指示器项。

pressX : real [只读, 自 QtQuick.Controls 2.4 (Qt 5.11) 开始]

此属性存储最后一次按下时的 x 坐标。

注意：该值在触摸移动时更新，但在触摸释放后保持不变。

此属性自 QtQuick.Controls 2.4 (Qt 5.11) 被引入。

另请参阅pressY。

pressY : real [只读, 自 QtQuick.Controls 2.4 (Qt 5.11) 开始]

此属性存储最后一次按下时的 y 坐标。

注意：该值在触摸移动时更新，但在触摸释放后保持不变。

此属性自 QtQuick.Controls 2.4 (Qt 5.11) 被引入。

另请参阅pressX。

pressed : bool [只读]

此属性存储按钮是否被物理按下。按钮可以通过触摸或键盘事件按下。

另请参阅down。

text : string

此属性存储按钮的文本描述。

注意：文本用于辅助功能目的，因此，即使在内容项是图像的情况下，也设置文本描述也是有意义的。

另请参阅icon、display 和 contentItem。

信号文档

已取消()

当按钮在按下时失去鼠标捕获或有可能会发出 released 信号但鼠标光标不在按钮内部时，会发出此信号。

注意：相应的处理程序是 onCanceled。

点击()

当用户通过触摸、鼠标或键盘交互式点击按钮时，会发出此信号。

注意：相应的处理程序是 onClicked。

另请参阅在按钮被点击时从 QML 调用 C++ 函数。

双击()

当用户通过触摸或鼠标交互式双击按钮时，会发出此信号。

注意：相应的处理程序是 onDoubleClicked。

按下并保持()

当用户通过触摸或鼠标交互式按下并保持按钮时，会发出此信号。当 autoRepeat 启用时，不会发出此信号。

注意：相应的处理程序是 onPressAndHold。

按下()

用户通过触摸、鼠标或键盘交互式按下按钮时，会发出此信号。

注意：相应的处理程序是 onPressed。

释放()

当用户通过触摸、鼠标或键盘交互式释放按钮时，会发出此信号。

注意：相应的处理程序是 onReleased。

[自 QtQuick.Controls 2.2 (Qt 5.9)] toggled()

当用户通过触摸、鼠标或键盘交互式切换可检查按钮时，会发出此信号。

注意：相应的处理程序是 onToggled。

此信号自 QtQuick.Controls 2.2 (Qt 5.9) 引入。

方法文档

void toggle()

切换按钮的选中状态。