前言

Qt是一种流行的跨平台的C++ GUI应用程序开发框架，用于构建图形用户界面(GUI)和其他桌面应用程序。QDial是Qt框架中的一个小部件，用于创建旋转式的拨号器。本文将介绍如何使用QDial进行基本的GUI应用程序开发，包括QDial的主要特性和方法，以及如何将其添加到应用程序的用户界面中。

一、QDial是什么

QDial很像大家在射击手游中的移动键。如下图所示：
在这里插入图片描述
接下来，我将带大家来学习QDial

二、操作api

构造函数：

QDial(QWidget *parent = nullptr)：构造一个 QDial 对象，并指定其父级窗口。

值设置和获取：

void setValue(int value)：设置 QDial 的当前值。
int value() const：获取 QDial 的当前值。

范围设置和获取：

void setRange(int minValue, int maxValue)：设置 QDial 的取值范围。
int minimum() const：获取 QDial 的最小值。
int maximum() const：获取 QDial 的最大值。

步长设置和获取：

void setSingleStep(int step)：设置 QDial 的步长。
int singleStep() const：获取 QDial 的步长。

外观设置和获取：

void setNotchesVisible(bool visible)：设置是否显示 QDial 上的刻度线。
bool notchesVisible() const：检查是否显示 QDial 上的刻度线。

返回 QDial 上刻度线的大小，
刻度线的大小指的是刻度线的长度。

int notchSize() const

返回 QDial 上刻度线的目标位置。
刻度线的目标位置是一个介于 0.0 和 1.0 之间的小数值，表示刻度线在 QDial 上的相对位置。

qreal notchTarget() const

设置 QDial 上刻度线的目标位置。
target 参数是一个介于 0.0 和 1.0 之间的小数值，表示刻度线在 QDial 上的相对位置。

void setNotchTarget(double target)

返回一个布尔值，指示 QDial 是否启用环绕模式。
如果环绕模式启用，旋转旋钮会在最小值和最大值之间循环；如果禁用，旋钮会在达到最小值或最大值时停止旋转。

bool wrapping() const

信号与槽

由于QDial继承于QAbstractSlider，所以QDial的信号与槽是和QAbstractSlider是一样的！

当范围值改变时

void rangeChanged(int min, int max)

当滑动时

void sliderMoved(int value)

当滑块被按下时

void sliderPressed()

当滑块释放时

void sliderReleased()

当值变化时

 void valueChanged(int value)

示例代码

因为其很简单，所以我并未创建Widget类，直接使用QWidget

#include <QApplication>
#include <QDial>
#include <QVBoxLayout>
#include <QDebug>
#include <QWidgt>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    // 创建主窗口及布局
    Widget window;
    QVBoxLayout layout(&window);

    // 创建 QDial
    QDial dial;
    
    // 设置 QDial 的取值范围和步长
    dial.setRange(0, 100);
    dial.setSingleStep(1);
    
    // 设置刻度线可见
    dial.setNotchesVisible(true);
    
    // 设置刻度线的目标位置
    dial.setNotchTarget(0.2);
    
    // 设置环绕模式启用
    dial.setWrapping(true);
    
    // 连接 QDial 的 valueChanged 信号到输出当前值
    QObject::connect(&dial, &QDial::valueChanged, [](int value){
        qDebug() << "Value:" << value;
    });

    // 将 QDial 添加到布局中
    layout.addWidget(&dial);

    // 显示窗口
    window.show();

    return app.exec();
}

上述示例代码创建了一个简单的窗口应用程序，其中包含一个 QDial 控件。在该示例中，我们将 QDial 的取值范围设置为 0 到 100，并将步长设置为 1。我们还通过设置 setNotchesVisible(true) 使刻度线可见，并使用 setNotchTarget(0.2) 设置刻度线的目标位置为 0.2。然后，我们使用 setWrapping(true) 启用了环绕模式。最后，我们通过连接 valueChanged 信号来输出 QDial 的当前值。

您可以根据需要在此示例代码的基础上进行修改和扩展，以适应您的实际需求。