【Qt】QDial和QSlider

QDial

QDial类用于创建一个旋转式的圆形控件，通过鼠标点击旋转、方向键或者pageUp和pageDown调整一个值。常用在需要进行连续调整的场景，比如音量控制、亮度控制、透明度调节等

常见属性

属性	说明
value	持有的值
minimum	持有值所能到达的最小值
maximum	持有值所能到达的最大值
singleStep	按下一次方向键，持有值改变的步长
pageStep	按下一次pageUp/pageDown，持有值改变的步长
sliderPosition	界面上旋钮显示的初始位置
tracking	外观是否会跟踪数值变化 默认值为true，一般不需要修改
wrapping	是否允许循环调整 即数值如果超过最大值，是否允许回到最小值 (调整过程能否“套圈”)
notchesVisible	是否显示刻度线
notchTarget	刻度线之间的间隔值 例如设置为5，即相邻刻度线持有值相差5 数字越大，刻度线越稀疏

核心信号

信号	说明
valueChanged(int)	数值改变时触发
rangeChanged(int, int)	范围变化时触发

示例：通过旋钮控制窗口的不透明度

#include "widget.h"
#include "ui_widget.h"

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);
    //opacity是一个0~1的浮点数，设置旋钮范围0~100，后续再计算
    ui->dial->setMinimum(0);
    ui->dial->setMaximum(100);
    //设置初始值为100，即完全不透明
    ui->dial->setValue(100);
    //设置方向键步长
    ui->dial->setSingleStep(10);
    //设置pageUp/pageDown步长
    ui->dial->setPageStep(5);
    //设置允许循环调整
    ui->dial->setWrapping(true);
    //设置刻度线可见和刻度线间隔
    ui->dial->setNotchesVisible(true);
}

Widget::~Widget()
{
    delete ui;
}


void Widget::on_dial_valueChanged(int value)
{
    ui->label->setText("当前旋钮的值：" + QString::number(value));
    this->setWindowOpacity((double)value / 100);
}

QSlider

QSlider类用于创建滑动条控件，允许用户通过拖动滑块来选择一个数值范围内的值。通常用于需要离散或连续数值调整的用户界面，比如音量调节、亮度控制、进度条等

常见属性

属性	说明
value	持有的值
minimum	持有值所能到达的最小值
maximum	持有值所能到达的最大值
singleStep	按下一次方向键，持有值改变的步长
pageStep	按下一次pageUp/pageDown，持有值改变的步长
sliderPosition	界面上旋钮显示的初始位置
tracking	外观是否会跟踪数值变化 默认值为true，一般不需要修改
orientation	滑动条的方向是水平还是垂直的 Qt::Orientation::Horizontal   水平 Qt::Orientation::Vertical        垂直
invertedAppearance	是否要翻转滑动条的方向
tickPosition	刻度的位置
tickInterval	刻度的密集程度

核心信号

信号	说明
valueChanged(int)	数值改变时触发
rangeChanged(int, int)	范围变化时触发

需了解的信号

信号	说明
actionTriggered(int)	数值改变时触发 该信号发出时，Qt在内存中维护的滑动条已经更新，但持有值和界面效果还没有更新 该信号在valueChanged信号发出前发出
sliderMoved(int)	通过拖拽的方式移动滑动条时触发
sliderPressed()	滑动条被按下，触发该信号
sliderReleased()	按下滑动条后松开，触发该信号

示例：通过一个水平滑动条和垂直滑动条改变窗口大小

#include "widget.h"
#include "ui_widget.h"

#include <QShortcut>
#include <QDebug>

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);
    //设置水平滑动条属性
    ui->horizontalSlider->setMinimum(500);//最小值
    ui->horizontalSlider->setMaximum(2000);//最大值
    ui->horizontalSlider->setValue(800);//初始值
    ui->horizontalSlider->setSingleStep(100);//方向键步长
    //设置垂直滑动条属性
    ui->verticalSlider->setOrientation(Qt::Orientation::Vertical);//设置垂直方向
    ui->verticalSlider->setInvertedAppearance(true);//设置反向，使其从上到下为数值增大
    ui->verticalSlider->setMinimum(500);//最小值
    ui->verticalSlider->setMaximum(1500);//最大值
    ui->verticalSlider->setValue(600);//初始值
    ui->verticalSlider->setSingleStep(100);//方向键步长
}

Widget::~Widget()
{
    delete ui;
}


void Widget::on_horizontalSlider_valueChanged(int value)
{
    //获取当前窗口的大小
    QRect rect = this->geometry();
    //宽度改变
    this->setGeometry(rect.x(), rect.y(), value, rect.height());
}

void Widget::on_verticalSlider_valueChanged(int value)
{
    //获取当前窗口的大小
    QRect rect = this->geometry();
    //长度改变
    this->setGeometry(rect.x(), rect.y(), rect.width(), value);
}

QShortcut快捷键

QShortcut类用于创建键盘快捷键，允许用户通过按下指定的键组合来触发特定的操作或功能

 QShortcut通过信号和槽机制实现快捷键。QShortcut绑定键盘的一个按键或按键组合，通过连接QShortcut的activated信号和对应槽函数实现快捷键被按下时，相应槽函数触发

---

示例：基于上述代码，为水平滑动条添加 -  和  +  两个快捷键，加号增加宽度，减号减小宽度

//设置 - 快捷键
QShortcut *shortcurSub = new QShortcut(this);
shortcurSub->setKey(QKeySequence("-"));//绑定-
//连接信号和槽函数
connect(shortcurSub, &QShortcut::activated, this, &Widget::valueSub);
//设置 + 快捷键
QShortcut *shortcurAdd = new QShortcut(this);
shortcurAdd->setKey(QKeySequence("+"));//绑定+
connect(shortcurAdd, &QShortcut::activated, this, &Widget::valueAdd);

void Widget::valueSub()
{
    QRect rect = this->geometry();
    //- 对应的槽函数，减小宽度
    this->setGeometry(rect.x(), rect.y(), rect.width() - 30, rect.height());
}

void Widget::valueAdd()
{
    QRect rect = this->geometry();
    //+ 对应的槽函数，增加宽度
    this->setGeometry(rect.x(), rect.y(), rect.width() + 30, rect.height());
}