按钮控件

Qt Quick 控件提供了选择按钮样式的控件。

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

按钮控件

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

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

建议

• 按钮的文本应是一个描述动作的动词，或是一个匹配将打开的弹出窗口标题的名词。
• 不要使用按钮来设置状态。 Switch 更加适合。
• 除非你有 UI 指南指定，否则使用默认字体。
• 如果文本是本地化的，请考虑较长的文本对布局的影响。

另请参阅 Button 和 AbstractButton

复选框控件

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

当需要一个是多/否选择时（如必须在表单中接受服务条款），请使用单个 CheckBox。

对于单选是/否选择，使用开关也是可能的。如果选择涉及选项，使用 CheckBox 是最好的。如果它涉及要执行的操作，则推荐使用开关。

当选项可分组时，可以使用部分勾选的 CheckBox 来表示整个组。当用户选择组中的某些子项但不是所有子项时，使用复选框的 部分勾选状态。

可选的勾选状态有三种：已勾选、部分勾选和未勾选。

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

建议

• 复选框标签应表示勾选时为真，未勾选时为假。
• 复选框标签不应包含否定陈述。
• 除非您有具体的UI指南，否则请使用默认字体。
• 如果文本是本地化的，请考虑较长的文本对布局的影响。

另请参见 CheckBox

DelayButton 控件

DelayButton 是一个在触发操作前会引入延迟的按钮。这种延迟可防止意外按下。

建议

• 适用于触摸用户界面。
• 适用于必须谨慎触发的操作。

另请参阅 Button 和 AbstractButton

RadioButton 控件

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

如果有两个互斥的选项，可以将它们组合成一个单选框或开关。

建议

• 将标签文本限制在一行。
• 确保有合理的默认选项被勾选。
• 垂直列出 RadioButton 选项。
• 如果文本是本地化的，请考虑较长的文本对布局的影响。
• 除非您有具体的UI指南，否则请使用默认字体。
• 与 CheckBox 类似，不要使列表过大。
• 为了避免混淆，不要将两组单选按钮放在一起。

另请参见 RadioButton

RoundButton 控件

RoundButton 是一个可点击的控制，可以开始一个操作，或打开或关闭弹出窗口。带方形图像图标或单个字母字体图标的圆形按钮是圆形的。圆形 RoundButton 比常规 Button 所占空间更小，也可以用作浮动动作按钮。

建议

• 请保持标签简短并精炼。
• 如果文本是本地化的，请考虑较长的文本对布局的影响。

另请参见 RoundButton

Switch 控件

Switch 代表一种物理开关，允许用户在“开启”和“关闭”状态之间进行选择。对于在开启后立即产生效果的二进制操作，请使用开关。例如，用于打开或关闭WIFI的开关。

建议

• 请保持标签简短并精炼。
• 如果文本是本地化的，请考虑较长的文本对布局的影响。

另请参见 Switch

ToolButton 控件

ToolButton 几乎与 Button 相同，但它具有更适合插入到 ToolBar 中的图形外观。

另请参见 ToolButton

相关信息

• Qt Quick 控件指南