QCheckBoxQRadioBoxQComboBoxQSlider

news2025/10/31 23:51:31

QCheckBox

QCheckBox 是 Qt 框架中一个常用的控件，用于创建一个可以勾选或取消勾选的复选框。它通常用于表示选项的开/关状态

autoExclusive 是一个与单选按钮（QRadioButton）相关的属性。这个属性决定了同一个父窗口下的单选按钮是否自动形成一个互斥的组，即在这个组中，任何时候只能有一个按钮被选中。

源码

测试代码

触发时机：
- clicked：当按钮被点击时触发，不管状态是否改变。
- toggled：当按钮的选中状态改变时触发。

QButtonGroup

按钮的逻辑分组：QButtonGroup 允许你将多个按钮（如 QPushButton、QRadioButton、QCheckBox 等）逻辑上分组在一起。这意味着你可以管理这些按钮的行为，使它们作为一个单元进行交互。
单选与多选：
- 对于 QRadioButton 类型的按钮，QButtonGroup 默认使组内的按钮表现为单选（只能有一个按钮被选中）。
- 对于 QCheckBox 类型的按钮，QButtonGroup 允许多选（可以选中多个按钮）。
信号：QButtonGroup 提供了几个有用的信号，如 buttonClicked(QAbstractButton *)，当组内的任何按钮被点击时发出。这样，你可以仅通过监视组的信号，而不是每个单独按钮的信号，来简化事件处理逻辑。
按钮的唯一性：在一个 QButtonGroup 中，每个按钮可以有一个唯一的标识符（通常是一个整数）。这使得你可以通过标识符来引用和区分不同的按钮。
布局无关：QButtonGroup 是一个不可视的对象，它不提供任何用户界面或布局功能。它仅用于管理按钮的逻辑和行为。

QRadioBox

基本使用：QRadioButton 允许用户从一组选项中选择一个。当一个单选按钮被选中时，同一组内的其他单选按钮（通常是同一个父窗体或 QButtonGroup 中的按钮）会自动被取消选中。
创建和配置：
- 可以通过代码或使用 Qt Designer 来创建 QRadioButton。
- 可以设置按钮的文本、图标、状态（选中/未选中）等。
信号：
- clicked()：当用户点击单选按钮时发出。
- toggled(bool)：当单选按钮的选中状态改变时发出，无论是通过用户交互还是程序设置。

QComboBox

QComboBox 是 Qt 框架中的一个控件，用于在下拉列表中显示一组选项。用户可以从列表中选择一个选项，也可以输入一个值（如果 QComboBox 被设置为可编辑的）。QComboBox 非常适用于需要从一组预定义选项中选择一个选项的情况。

源码

常用方法

void addItem(const QString &text)：添加一个带有指定文本的选项。
void addItems(const QStringList &texts)：添加一个字符串列表中的多个选项。
QString currentText() const：返回当前选定选项的文本。
int currentIndex() const：返回当前选定选项的索引。
void setEditable(bool editable)：设置 QComboBox 是否可编辑。

QVariant

Q_DECLARE_METATYPE 是 Qt 框架中的一个宏，用于在 Qt 的元对象系统中声明任何非 Qt 类型。这样声明的类型可以用于 Qt 的信号和槽机制，以及其他需要类型信息的功能，如属性系统、变体类 QVariant 等。

当你想要在 Qt 的信号和槽中使用自定义类型，或者想要将自定义类型存储在 QVariant 中时，就需要使用 Q_DECLARE_METATYPE。

QComboBox信号

`activated` 信号

触发时机：当用户从下拉列表中选择一个选项时，activated 信号被触发。这个信号只有在用户的操作导致选项改变时才会发出，即通过鼠标点击或键盘选择。
常见用途：activated 通常用于响应用户的直接交互，如当用户选择了一个新的选项时执行特定的操作。
版本：有两个版本的 activated 信号：
- void activated(int index)：发送选项的索引。
- void activated(const QString &text)：发送选项的文本。

`currentIndexChanged` 信号

触发时机：无论当前选中的项是通过用户操作还是通过程序代码更改的，currentIndexChanged 信号都会被触发。它更广泛地反映了 QComboBox 选项的任何改变。
常见用途：这个信号常用于更新与 QComboBox 选项相关联的数据或状态，不管这个改变是如何引起的。
版本：同样有两个版本的 currentIndexChanged 信号：
- void currentIndexChanged(int index)：发送选项的索引。
- void currentIndexChanged(const QString &text)：发送选项的文本。

QSlider

常用方法

void setMinimum(int)：设置滑动条的最小值。
void setMaximum(int)：设置滑动条的最大值。
void setRange(int min, int max)：一次性设置滑动条的最小值和最大值。
void setValue(int)：设置滑动条的当前值。
int value() const：获取滑动条的当前值。
void setOrientation(Qt::Orientation)：设置滑动条的方向（水平或垂直）。

SingleStep

定义：singleStep 属性定义了当用户使用箭头键或类似的小幅度调节控件时，控件值改变的步长。
用途：这个属性通常用于精细调节。例如，在 QSlider 中，当用户点击滑块两边的小箭头时，滑块移动的量就是由 singleStep 决定的。
设置方法：使用 setSingleStep(int step) 方法来设置这个值。

PageStep (SinglePage)

定义：pageStep（在某些上下文中可能称为 singlePage）属性定义了当用户执行更大幅度的调整时，如点击滑块轨道，控件值改变的步长。
用途：这个属性用于大幅度调节。在 QSlider 控件中，点击滑块轨道（但不是滑块本身）会使滑块移动一个 pageStep 的量。
设置方法：使用 setPageStep(int step) 方法来设置这个值

源码

信号

valueChanged(int)：当滑块的值改变时发出。
sliderMoved(int)：当用户拖动滑块时发出。
sliderPressed() 和 sliderReleased()：当用户按下或释放滑块时发出。

qss样式

QSlider::groove { /*滑动槽*/
border: 1px solid #999999;
height: 28px;
background: rgba(155,155,155,200);
border-radius: 10px;
}

QSlider::handle { /*滑动把手*/
background: rgba(255,0,0,200);
width: 20px;
margin: -10px 0;
border: 1px solid rgba(255,0,0,200);
border-radius: 10px;
}