按钮控件
Qt快速控制提供了一系列类似按钮的控件。
提供按钮通用功能的抽象基类型 | |
可单击以执行命令或回答问题的按钮 | |
可以打开或关闭的检查按钮 | |
按住足够长的时间时触发的检查按钮 | |
可打开或关闭的专用单选按钮 | |
带有圆角的按钮控件,可由用户单击。 | |
可以打开或关闭的按钮 | |
外观适合工具栏的按钮 |
每种类型的按钮都有其特定的用例。以下部分提供了根据用例选择适当类型的按钮的指南。
按钮控制
是启动操作或打开或关闭弹出窗口的可单击控件。按钮通常具有文本标签,但也可以包含图标。
当弹出窗口或对话框需要执行操作时,按钮是一个非常合适的控件。最常见的示例是“应用”、“取消”、“保存”、“关闭”和“帮助”。
建议:
- 按钮的文本应该是描述操作的谓词,或者是与将打开的弹出窗口标题匹配的名词。
- 不要使用按钮来设置状态。更适合那个。
- 使用默认字体,除非您有 UI 指南另行指定。
- 如果文本已本地化,请考虑较长文本对布局的影响。
另请参阅和
复选框控件
用于构建多选选项列表。可以选择任意数量的选项,包括无选项,但这些选项不应相互排斥。
使用单个选项表示是/否选项,例如,当您必须接受表单中的服务条款协议时。
对于单个是/否选项,也可以使用开关。如果选择涉及选项,最好使用 .如果涉及要执行的操作,建议进行切换。
当选项可以分组时,可以使用部分选中来表示整个组。当用户选择组中的某些(但不是全部)子项时,请使用该复选框。
三种可用的检查状态是:已检查、部分检查和未选中。
可检查的选项通常垂直列出。
建议:
- 复选框标签应该是复选标记为 true 的语句,缺少复选标记的语句为 false。
- 复选框标签不应包含否定语句。
- 使用默认字体,除非另有指定 UI 准则。
- 如果文本已本地化,请考虑较长文本对布局的影响。
参见
延迟按钮控制
是一个按钮,在触发操作之前包含延迟。此延迟可防止意外按下。
建议:
- 在触摸用户界面中使用。
- 用于必须小心触发的操作。
另请参阅和
单选按钮控制
用于从一组选项中仅选择一个选项。选择一个选项会自动取消选择之前选择的选项。
如果只有两个互斥选项,请将它们组合到一个复选框或开关中。
建议:
- 将标签文本限制为一行。
- 确保选中合理的默认选项。
- 垂直列出选项。
- 如果文本已本地化,请考虑较长文本对布局的影响。
- 使用默认字体,除非有另行指定的 UI 准则。
- 就像 一样,不要使列表太大。
- 为了避免混淆,不要将两组单选按钮并排放置。
按钮控件的具体使用:
提供按钮通用功能的抽象基类型。更多。。。
Import Statement: | import QtQuick.Controls 2.15 |
Since: | Qt 5.7 |
Inherits: | |
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
信号
方法
- 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 |
此属性保存按钮是否可检查。
当用户单击可检查按钮或在按钮具有活动焦点时按空格键时,可在选中(打开)和未选中(关闭)之间切换。
设置为 强制此属性为 。true
true
默认值为 。false
另请参阅。
checked : bool |
此属性保存是否选中按钮。
另请参阅。
display : enumeration |
此属性确定 和 在按钮中的显示方式。
显示 | 结果 |
---|---|
AbstractButton.IconOnly | |
AbstractButton.TextOnly | |
AbstractButton.TextBesideIcon | |
AbstractButton.TextUnderIcon |
此属性在 QtQuick.Controls 2.3 (Qt 5.10) 中引入。
另请参阅和。
down : bool |
此属性保存按钮是否在视觉上关闭。
除非显式设置,否则此属性将遵循 的值。要返回到默认值,请将此属性设置为 。undefined
另请参阅。
此属性组已添加到 中。控件 2.3.
名字 | 描述 |
---|---|
名字 | 此属性保存要使用的图标的名称。 图标将从平台主题加载。如果在主题中找到该图标,它将始终被使用;即使也设置了。如果未找到该图标,将改用。 有关主题图标的详细信息,请参见。 |
源 | 此属性保存要使用的图标的名称。 该图标将作为常规图像加载。 如果 设置为 并引用有效的主题图标,将始终使用它来代替此属性。 |
宽度 | 此属性保存图标的宽度。 图标的宽度永远不会超过此值,但在必要时会缩小。 |
高度 | 此属性保存图标的高度。 图标的高度永远不会超过此值,但在必要时会缩小。 |
颜色 | 此属性保存图标的颜色。 图标使用指定的颜色着色,除非颜色设置为 。 |
缓存 | 此属性指定是否应缓存图标。 默认值为 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) 中引入。