QML AbstractButton类

AbstractButton类提供按钮通用功能的抽象基类型。

导入	import QtQuick.Controls 2.1
继承	Control
被继承	Button, CheckBox, DelayButton, ItemDelegate, MenuBarItem, MenuItem, RadioButton, Switch, and TabButton

Properties

• action : Action
• autoExclusive : bool
• autoRepeat : bool
• autoRepeatDelay : int
• autoRepeatInterval : int
• checkable : bool
• checked : bool
• display : enumeration
• down : bool
• icon
  • icon.cache : bool
  • icon.color : color
  • icon.height : int
  • icon.name : string
  • icon.source : url
  • icon.width : int
• implicitIndicatorHeight : real
• implicitIndicatorWidth : real
• indicator : Item
• pressX : real
• pressY : real
• pressed : bool
• text : string

Signals

• canceled()
• clicked()
• doubleClicked()
• pressAndHold()
• pressed()
• released()
• toggled()

Methods

• void toggle()

属性
action : Action
此属性保存按钮动作。Action

autoExclusive : bool
此属性保存是否启用了auto-exclusivity。

如果启用了auto-exclusivity，属于同一父项的可检查按钮的行为就好像它们是同一ButtonGroup的一部分。只有一个按钮可以随时查看;勾选另一个按钮会自动取消先前选中的按钮。

注意：该属性对属于ButtonGroup的按钮没有影响。

autoRepeat : bool
当按钮被按下并按下时，该属性保存按钮是否重复pressed()、released()和clicked()信号。

如果该属性被设置为true，则不会触发pressAndHold()信号。

缺省值为false。

初始延迟和重复间隔由autoRepeatDelay和autoRepeatInterval定义，以毫秒为单位。

autoRepeatDelay : int
此属性保存自动重复的初始延迟，以毫秒为单位。缺省值是300ms。

autoRepeatInterval : int
此属性保存以毫秒为单位的自动重复间隔。缺省值是100毫秒。

checkable : bool
此属性保存按钮是否可勾选。

当用户单击可勾选按钮或按下空格键时，可勾选按钮在已勾选(打开)和未勾选(关闭)之间切换，而该按钮具有活动焦点。

将checked设置为true将强制此属性为true。

缺省值为false。

checked : bool
此属性保存按钮是否被选中。

display : enumeration
此属性决定图标和文本在按钮中的显示方式。

down : bool
此属性保持按钮是否在可视状态下。

除非显式设置，否则此属性紧跟在pressed的值之后。若要返回默认值，请将此属性设置为undefined。

icon
icon.cache : bool
此属性指定是否应该缓存图标。缺省值为true。

icon.color : color
此属性保存图标的颜色。

图标将使用指定的颜色着色，除非该颜色被设置为“透明”。

icon.height : int
此属性保存图标的高度。

图标的高度永远不会超过这个值，尽管它会在必要时收缩。

icon.name : string
此属性保存要使用的图标的名称。

图标将从平台主题加载。如果图标出现在主题中，它将始终被使用；即使 icon.source也是设置好的。如果没有找到图标，则使用 icon.source。

icon.source : url
此属性保存要使用的图标的名称。

该图标将作为常规图像加载。如果设置了icon.name并引用了一个有效的主题图标，则将始终使用它而不是此属性。

icon.width : int
此属性保存图标的宽度。图标的宽度永远不会超过这个值，但它会在必要时收缩。

implicitIndicatorHeight : real
此属性保存隐式指示符的高度。

这个值等于indicator ? indicator.implicitHeight : 0.

implicitIndicatorWidth : real
此属性保存隐式指示符宽度。

这个值等于indicator ? indicator.implicitWidth : 0.

indicator : Item
此属性保存指示器item。

pressX : real
此属性保存最后一次按下的x坐标。

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

pressY : real

pressed : bool
此属性保存按钮是否物理按下。按钮可以通过触摸或按键事件按下。

text : string
此属性保存按钮的文本描述。

注意：文本用于可访问性目的，因此即使内容项是图像，设置文本描述也是有意义的。

信号
canceled()
当按钮在被按下时失去鼠标抓取时，或者当鼠标光标不在按钮内部时，它将发出释放的信号。

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

clicked()
当用户通过触摸、鼠标或键盘交互地单击按钮时，就会发出这个信号。

注意:对应的处理程序是onClicked。

doubleClicked()
当用户通过触摸或鼠标交互式地双击按钮时，就会发出这个信号。

注意:对应的处理程序是onDoubleClicked。

pressAndHold()
当用户通过触摸或鼠标交互式地按下按钮时，就会发出这个信号。启用autoRepeat时不会触发。

注意:对应的处理程序是onPressAndHold。

pressed()
当用户通过触摸、鼠标或键盘交互地按下按钮时，就会发出这个信号。

注意:对应的处理程序是onPressed。

released()
当用户通过触摸、鼠标或键盘交互地释放按钮时，就会发出这个信号。

注意:对应的处理程序是onReleased。

toggled()
当用户通过触摸、鼠标或键盘交互地切换可检查按钮时，就会发出这个信号。

注意:对应的处理程序是onToggled。

方法
void toggle()
切换按钮的选中状态。