按钮控件

Qt Quick Controls 提供了一系列类似按钮的控件。

每种按钮都有其特定的使用情况。以下各节将根据使用情况提供选择适当按钮类型的指南。

按钮控件

Button 是一种可点击的控件，用于启动一个动作，或打开或关闭一个弹出窗口。按钮通常有一个文本标签，但也可以包含一个图标。

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

建议

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

另请参见 Button 和AbstractButton

复选框控件

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

对于 "是/否 "选项，如必须接受表单中的服务协议条款时，可使用单个CheckBox 。

对于单个 "是"/"否 "选项，也可以使用开关。如果选择与选项有关，最好使用CheckBox 。如果选择与要采取的行动有关，建议使用开关。

当选项可以分组时，可以使用部分选中的CheckBox 来代表整组。当用户选择了组中的部分而非全部子项时，可以使用复选框的partially checked state 。

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

可选中的选项通常垂直排列。

建议

• 复选框标签应说明复选标记为 "真"，无复选标记为 "假"。
• 复选框标签不应包含否定声明。
• 使用默认字体，除非用户界面指南另有规定。
• 如果文本是本地化的，请考虑较长文本对布局的影响。

另请参见 CheckBox

延迟按钮控件

DelayButton 是一种在触发操作前包含延迟的按钮。这种延迟可防止意外按下。

建议使用：

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

另请参阅 Button 和AbstractButton

单选按钮控件

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

如果只有两个相互排斥的选项，可将它们合并为一个复选框或开关。

建议

• 将标签文本限制为一行。
• 确保选中合理的默认选项。
• 垂直列出RadioButton 选项。
• 如果文本是本地化的，请考虑较长文本对布局的影响。
• 使用默认字体，除非用户界面指南另有规定。
• 与CheckBox 一样，不要使列表过大。
• 为避免混淆，不要将两组单选按钮放在一起。

另请参见 RadioButton

圆形按钮控件

RoundButton 是一个可点击的控件，用于启动一个操作，或打开或关闭一个弹出窗口。带有方形图像图标或单字字体图标的圆形按钮是圆形按钮。圆形 占用的空间比普通 小，也可用作浮动操作按钮。RoundButton Button

建议：

• 标签应简明扼要。
• 如果文本是本地化的，请考虑较长文本对布局的影响。

另请参见 RoundButton

开关控制

Switch 表示允许用户在 "开 "或 "关 "状态之间进行选择的物理开关。开关适用于开启后立即生效的二进制操作。例如，打开或关闭 WIFI 的开关。

建议：

• 标签应简明扼要。
• 如果文本是本地化的，请考虑较长文本对布局的影响。

另请参见 Switch

工具按钮控件

ToolButton 与 几乎相同，但它的图形外观使其更适合插入 。Button ToolBar

另请参见 ToolButton

相关信息

• Qt Quick Controls 指南