QT的按钮按钮控件

按钮控件

Qt快速控制提供了一系列类似按钮的控件。

AbstractButton	提供按钮通用功能的抽象基类型
Button	可单击以执行命令或回答问题的按钮
CheckBox	可以打开或关闭的检查按钮
DelayButton	按住足够长的时间时触发的检查按钮
RadioButton	可打开或关闭的专用单选按钮
RoundButton	带有圆角的按钮控件，可由用户单击。
Switch	可以打开或关闭的按钮
ToolButton	外观适合工具栏的按钮

每种类型的按钮都有其特定的用例。以下部分提供了根据用例选择适当类型的按钮的指南。

按钮控制

是启动操作或打开或关闭弹出窗口的可单击控件。按钮通常具有文本标签，但也可以包含图标。

当弹出窗口或对话框需要执行操作时，按钮是一个非常合适的控件。最常见的示例是“应用”、“取消”、“保存”、“关闭”和“帮助”。

建议：

• 按钮的文本应该是描述操作的谓词，或者是与将打开的弹出窗口标题匹配的名词。
• 不要使用按钮来设置状态。更适合那个。
• 使用默认字体，除非您有 UI 指南另行指定。
• 如果文本已本地化，请考虑较长文本对布局的影响。

另请参阅和

复选框控件

用于构建多选选项列表。可以选择任意数量的选项，包括无选项，但这些选项不应相互排斥。

使用单个选项表示是/否选项，例如，当您必须接受表单中的服务条款协议时。

对于单个是/否选项，也可以使用开关。如果选择涉及选项，最好使用 .如果涉及要执行的操作，建议进行切换。

当选项可以分组时，可以使用部分选中来表示整个组。当用户选择组中的某些（但不是全部）子项时，请使用该复选框。

三种可用的检查状态是：已检查、部分检查和未选中。

可检查的选项通常垂直列出。

建议：

• 复选框标签应该是复选标记为 true 的语句，缺少复选标记的语句为 false。
• 复选框标签不应包含否定语句。
• 使用默认字体，除非另有指定 UI 准则。
• 如果文本已本地化，请考虑较长文本对布局的影响。

参见

延迟按钮控制

是一个按钮，在触发操作之前包含延迟。此延迟可防止意外按下。

建议：

• 在触摸用户界面中使用。
• 用于必须小心触发的操作。

另请参阅和

单选按钮控制

用于从一组选项中仅选择一个选项。选择一个选项会自动取消选择之前选择的选项。

如果只有两个互斥选项，请将它们组合到一个复选框或开关中。

建议：

• 将标签文本限制为一行。
• 确保选中合理的默认选项。
• 垂直列出选项。
• 如果文本已本地化，请考虑较长文本对布局的影响。
• 使用默认字体，除非有另行指定的 UI 准则。
• 就像 一样，不要使列表太大。
• 为了避免混淆，不要将两组单选按钮并排放置。

按钮控件的具体使用：

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

Import Statement:	import QtQuick.Controls 2.15
Since:	Qt 5.7
Inherits:	Control
Inherited By:	Button, CheckBox, DelayButton, ItemDelegate, MenuBarItem, MenuItem, RadioButton, Switch, and TabButton

• 所有成员的列表，包括继承的成员

性能

• 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

信号

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

方法

• void toggle()

详细说明

抽象按钮为具有类似按钮行为的控件提供了接口;例如，按钮和可检查控件，如单选按钮和复选框。作为一个抽象控件，它没有委托实现，将它们留给从它派生的类型。

另请参阅和。

属性文档

action : Action

此属性保存按钮操作。

此属性在 QtQuick.Controls 2.3 （Qt 5.10） 中引入。

另请参阅。

 

autoExclusive : bool

此属性保存是否启用了自动独占性。

如果启用了自动独占性，则属于同一父项的可检查按钮的行为就像它们是同一 .任何时候只能检查一个按钮;选中另一个按钮会自动取消选中之前选中的按钮。

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

并且默认情况下是自动独占的。

 

autoRepeat : bool

此属性保存按钮是否重复，并在按下并按住按钮时发出信号。

如果此属性设置为 ，则不会发出信号。true

默认值为 。false

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

 

autoRepeatDelay : int

此属性保存自动重复的初始延迟（以毫秒为单位）。默认值为 ms。300

此属性在 QtQuick.Controls 2.4 （Qt 5.11） 中引入。

另请参阅和。

 

autoRepeatInterval : int

此属性保存自动重复的间隔（以毫秒为单位）。默认值为 ms。100

此属性在 QtQuick.Controls 2.4 （Qt 5.11） 中引入。

另请参阅和。

 

checkable : bool

此属性保存按钮是否可检查。

当用户单击可检查按钮或在按钮具有活动焦点时按空格键时，可在选中（打开）和未选中（关闭）之间切换。

设置为 强制此属性为 。truetrue

默认值为 。false

另请参阅。

 

checked : bool

此属性保存是否选中按钮。

另请参阅。

 

display : enumeration

此属性确定 和 在按钮中的显示方式。

显示	结果
AbstractButton.IconOnly
AbstractButton.TextOnly
AbstractButton.TextBesideIcon
AbstractButton.TextUnderIcon

此属性在 QtQuick.Controls 2.3 （Qt 5.10） 中引入。

另请参阅和。

 

down : bool

此属性保存按钮是否在视觉上关闭。

除非显式设置，否则此属性将遵循 的值。要返回到默认值，请将此属性设置为 。undefined

另请参阅。

 

icon group
icon.cache : bool
icon.color : color
icon.height : int
icon.name : string
icon.source : url
icon.width : int

此属性组已添加到 中。控件 2.3.

名字	描述
名字	此属性保存要使用的图标的名称。 图标将从平台主题加载。如果在主题中找到该图标，它将始终被使用;即使也设置了。如果未找到该图标，将改用。 有关主题图标的详细信息，请参见。
源	此属性保存要使用的图标的名称。 该图标将作为常规图像加载。 如果 设置为 并引用有效的主题图标，将始终使用它来代替此属性。
宽度	此属性保存图标的宽度。 图标的宽度永远不会超过此值，但在必要时会缩小。
高度	此属性保存图标的高度。 图标的高度永远不会超过此值，但在必要时会缩小。
颜色	此属性保存图标的颜色。 图标使用指定的颜色着色，除非颜色设置为 。"transparent"
缓存	此属性指定是否应缓存图标。 默认值为 true。 此属性已在 中介绍。控件 2.13.

另请参见 、 和 。

 

[read-only]implicitIndicatorHeight : real

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

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

这通常与 和 一起使用来计算 。

此属性在 QtQuick.Controls 2.5 （Qt 5.12） 中引入。

另请参阅。

 

[read-only]implicitIndicatorWidth : real

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

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

这通常与 和 一起使用来计算 。

此属性在 QtQuick.Controls 2.5 （Qt 5.12） 中引入。

另请参阅。

 

indicator : Item

此属性保存指示器项。

 

[read-only]pressX : real

此属性保存上次按下的 x 坐标。

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

此属性在 QtQuick.Controls 2.4 （Qt 5.11） 中引入。

另请参阅。

 

[read-only]pressY : real

此属性保存上次按下的 y 坐标。

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

此属性在 QtQuick.Controls 2.4 （Qt 5.11） 中引入。

另请参阅。

 

[read-only]pressed : bool

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

另请参阅。

 

text : string

This property holds a textual description of the button.

Note: The text is used for accessibility purposes, so it makes sense to set a textual description even if the content item is an image.

See also icon, display, and contentItem.

 

信号文档

canceled()

当按钮在按下时失去鼠标抓取时，或者当它会发出信号但鼠标光标不在按钮内时，会发出此信号。

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

 

clicked()

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

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

 

doubleClicked()

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

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

 

pressAndHold()

当用户通过触摸或鼠标以交互方式按下并按住按钮时，将发出此信号。启用时不会发出它。

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

 

pressed()

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

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

 

released()

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

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

 

toggled()

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

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

此信号在 QtQuick.Controls 2.2 （Qt 5.9） 中引入。