QT的QPen详细介绍

最新推荐文章于 2025-03-24 10:45:09 发布
最新推荐文章于 2025-03-24 10:45:09 发布
阅读量3.2k 收藏 20
点赞数 29
文章标签： qt 开发语言
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2401_83283786/article/details/137611980
版权
本文围绕Qt中的QPen类展开，介绍其用于定义绘图系统中线条外观属性。详细讲解了QPen的主要属性，如颜色、宽度、样式等，还对QPen类的成员函数和非成员函数进行了分析，包括构造函数、析构函数、获取和设置属性的函数等，以及序列化相关函数。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

此篇文章来源于自己在学习QT过程中遇到Qpen时总结的知识点，覆盖每个成员函数的相关代码讲解，本人水平有限，如果有其他问题，大家在评论区交流即可，共同学习，一起进步。

一、QPen简介

Qt中的QPen类是一个核心图形模块中的重要类，用于定义Qt绘图系统中线条的外观属性。QPen类的对象代表了一支虚拟的“画笔”，你可以通过设置它的各种属性来控制使用QPainter在QPaintDevice上绘制直线、曲线或形状轮廓时线条的表现。

QPen的主要属性包括：

  1. 颜色 (color() 或 set_color())：

    • 可以设置为任意的QColor对象，用来指定线条的颜色。例如，可以通过预定义的颜色常量如Qt::black设置为黑色，也可以使用RGB、ARGB值自定义颜色。

  2. 宽度 (width() 或 setWidth(), widthF() 或 setWidthF()):

    • 设置线条的粗细，可以是整数值或浮点数，单位通常与设备相关的像素或逻辑单位。

  3. 样式 (style() 或 setStyle()):

    • 定义线条的基本形状，比如连续线(SolidLine)、虚线(DashLine)、点线(DotLine)、中心线(DashDotLine)等等。

  4. 笔刷 (brush() 或 setBrush()):

    • 使用QBrush对象来填充线条，允许线条具有复杂的填充样式，例如渐变色或图案填充。

  5. 线帽样式 (capStyle() 或 setCapStyle()):

    • 控制线段末端的形状，可选样式包括平头(SquareCap)、圆头(RoundCap)和默认(FlatCap)。

  6. 连接样式 (joinStyle() 或 setJoinStyle()):

    • 决定两线段相交或转折处的连接方式，如斜接(BevelJoin)、圆角(RoundJoin)和平接(MiterJoin)。

二、成员函数

1、QPen::QPen(QPen &&pen)

        这个构造函数的作用是执行资源的移动操作，而不是复制操作。当一个新的QPen对象通过右值引用（rvalue reference）来初始化时，它会接管原有QPen对象的所有权和状态，而原QPen对象通常会被置为空状态或者不可用状态，避免了昂贵的深拷贝。

具体到QPen类，这意味着新创建的QPen对象将直接获取原始QPen对象所包含的颜色、宽度、样式等所有属性，并且不会额外分配新的内存资源。这样的设计有助于提高性能，尤其是在处理大型数据结构或者频繁创建销毁临时对象的情况下。

示例代码：

QPen originalPen(Qt::blue, 2, Qt::SolidLine);
// 创建一个新的QPen对象，通过移动构造函数从originalPen那里接管状态
QPen movedPen(std::move(originalPen));
// 这时，movedPen拥有了originalPen的所有属性，而originalPen可能处于未定义状态或空状态

在上述代码片段中，std::move是一个强制转换操作，用于表明我们打算放弃对原始QPen对象的所有权，将其资源转移给新创建的QPen对象。

2、QPen::QPen(const QPen &pen)

QPen::QPen(const QPen &pen) 是C++中QPen类的一个复制构造函数。这个函数用于创建一个新的QPen对象，该对象是已存在QPen对象的一个副本，即新对象的属性完全复制自传入的参数pen。

在Qt的绘图系统中，当你需要创建一个与现有QPen相同属性的新画笔时，就会用到这个复制构造函数。例如，你可能需要在一个地方保存原始画笔的状态，然后基于此创建并修改一个新的画笔。

示例代码：

QPen originalPen(Qt::blue, 2, Qt::SolidLine);
// 创建一个新的QPen对象，其属性与originalPen完全一致
QPen copiedPen(originalPen);
// 此时，copiedPen和originalPen都有相同的颜色（蓝色）、宽度（2像素）和样式（实线）

在这个过程中，复制构造函数将会对原始QPen对象的颜色、宽度、样式以及其他所有相关属性进行深度复制，确保新创建的QPen对象与原始对象有独立但相同的属性设置。

3、QPen::QPen(const QBrush &brush, qreal width, Qt::PenStyle style = Qt::SolidLine, Qt::PenCapStyle cap = Qt::SquareCap, Qt::PenJoinStyle join = Qt::BevelJoin)

此函数是Qt框架中的QPen类的一个构造函数，它用于初始化一个新的QPen对象，该对象定义了绘制图形轮廓的属性。

  • const QBrush &brush: 指定画笔的颜色或图案，可以是一个纯色或渐变色等复杂填充方式的QBrush对象。

  • qreal width: 设置画笔的宽度，单位通常为逻辑像素。

  • Qt::PenStyle style: 定义画笔的线条样式，可选值包括但不限于：

    • Qt::SolidLine（实线）
    • Qt::DashLine（虚线）
    • Qt::DotLine（点线）
    • 等其他多种风格

  • Qt::PenCapStyle cap: 指定线条端点的形状，如：

    • Qt::SquareCap（方形）
    • Qt::RoundCap（圆形）
    • Qt::FlatCap（平头）

  • Qt::PenJoinStyle join: 定义两条线段交汇处的连接方式，例如：

    • Qt::BevelJoin（斜角连接）
    • Qt::RoundJoin（圆角连接）
    • Qt::MiterJoin（尖角连接）

通过这个构造函数，您可以一次性创建一个具有指定颜色、宽度、线条样式、线帽样式以及线连接样式的QPen对象，并将其应用于 QPainter 对象来进行2D绘图操作。如果不指定某些参数，则会使用默认值，如上述构造函数声明所示。

4、QPen::QPen(const QColor &color)

QPen::QPen(const QColor &color) 是Qt框架中QPen类的一个构造函数，它的目的是创建一个基于给定颜色的新QPen对象。这个构造函数简化了创建只设置颜色属性的画笔的过程，而其它属性如宽度、线条样式、线帽样式和线连接样式则采用QPen类的默认值。

  • const QColor &color: 这个参数是用来指定画笔颜色的，QColor是Qt中的颜色类，它可以表示各种RGB、RGBA或其他颜色空间中的颜色。

通过此构造函数创建的QPen将会具有用户指定的颜色，并且默认宽度为1，线条样式为实线（Qt::SolidLine），线帽样式为方形（Qt::SquareCap），线连接样式为斜角连接（Qt::BevelJoin）。这样的QPen对象常被用于在QPainter上下文中绘制具有单一颜色边界的图形元素。

#include <QApplication>
#include <QWidget>
#include <QPainter>
#include <QColor>

class DrawingWidget : public QWidget {
public:
    DrawingWidget(QWidget *parent = nullptr) : QWidget(parent) {}

protected:
    void paintEvent(QPaintEvent *) override {
        QPainter painter(this);

        // 创建一个红色的QPen
        QPen redPen(QColor("red"));
        
        // 设置当前画笔为红色画笔
        painter.setPen(redPen);

        // 使用红色画笔绘制一个矩形
        painter.drawRect(50, 50, 200, 100);
    }
};

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    
    DrawingWidget widget;
    widget.show();

    return app.exec();
}

在这个例子中，我们首先定义了一个继承自QWidget的DrawingWidget类，在其paintEvent方法中，我们创建了一个带有红色颜色的QPen对象，然后将其设置为当前QPainter的画笔。接着，我们使用这个设置了红色画笔的QPainter来绘制一个矩形，这样矩形的边框就会显示为红色。

5、QPen::QPen(Qt::PenStyle style)

QPen::QPen(Qt::PenStyle style) 是Qt库中QPen类的一个构造函数，它接收一个Qt::PenStyle类型的参数，用于创建一个仅定义了线条样式的新QPen对象。Qt::PenStyle枚举类型包含了多种线条样式，例如实线(SolidLine)、虚线(DashLine)、点线(DotLine)等。

这个构造函数创建的QPen对象的其它属性，如颜色、宽度、线帽样式和线连接样式，都将采用默认值。例如，默认颜色是黑色，宽度默认为1，线帽和线连接样式也有各自的默认值。

以下是一个简单的示例：

QPen dashedPen(Qt::DashLine);

上面的代码将创建一个样式为虚线的QPen对象，其颜色和宽度均为默认值。这个QPen对象可以用于QPainter进行绘图操作，使绘制出的线条呈现虚线效果。

6、QPen::~QPen()

QPen::~QPen() 是Qt库中QPen类的析构函数。在C++中，析构函数是一个特殊的方法，当一个对象生命周期结束时（比如对象的作用域结束或者显式调用delete销毁对象时）自动调用，用于释放该对象所占用的资源。

对于QPen类来说

最低0.47元/天 解锁文章
Qt中的QPen类详解
TechRoarX的博客
08-26 1015
这里我们使用QPainter对象的setPen()函数设置当前绘图设备的画笔为我们创建的QPen对象。然后通过drawLine()函数在画布上绘制一条从点(10,10)到点(100,100)的线段。在Qt中，QPen是一个用于绘制直线、曲线等形状的笔刷类。它可以设置线条的颜色、宽度、样式等属性。下面我们来详细了解一下QPen类的使用以及一些常见操作。这里我们将颜色设置为黑色，如果需要设置其他颜色可以使用Qt中提供的预定义颜色或者使用RGB值进行设置。以上就是QPen类的基本用法，希望对大家有所帮助。
QT的QPen类的使用
希望我的博客，能帮上你解决学习中工作中所遇到的问题
12-20 3082
详细说明 QPen类定义QPainter应该如何绘制形状的线条和轮廓。 笔具有style（），width（），brush（），capStyle（）和joinStyle（）。 笔样式定义线型。笔刷用于填充笔产生的笔划。使用QBrush类指定填充样式。顶盖样式确定可以使用QPainter绘制的线端盖，而连接样式描述如何绘制两条线之间的连接。笔宽度可以整数（width（））和浮点（widthF（））精度指定。线宽为零表示化妆笔。这意味着笔宽始终绘制为一个像素宽，而与画家设置的变换无关。 可以使用相应的setSty
【Qt之QPen】
FreeLikeTheWind的博客
12-01 832
首先，我们创建了一个 QPen 对象，并设置画笔的颜色、宽度和风格，然后使用 QPainter 对象的 setPen 函数将画笔设置为当前绘制的画笔。继而，我们调用 QPainter 对象的 drawRect 函数来绘制矩形。最终，通过重载 QWidget 的 paintEvent 函数，在需要绘制的时候调用 QPainter 对象的绘制函数来完成绘制。下面是一个简单的使用 QPen 类的示例，用于在 QWidget 上绘制一个矩形。QPen 类是 Qt 框架中的一个类，用于定义绘制的画笔。
Qt 画笔和画刷 QPen&QBrush
最新发布
LoveXming的博客
03-24 375
Qt 画笔 画刷 QPen QBrush 重绘 绘图
Qt源码分析--QPen
exlink2012的专栏
01-25 1314
​ QPen 类定义如何以QPainter绘制线条和形状的轮廓。 解析了style(), width(), brush(), capStyle() , joinStyle()以及相应的设置函数。 ​
QT Road之【QPen】
wasb001的专栏
06-08 1万+
细节描述： QPen类的用途：定义了一个QPainter应如何画线和图形的轮廓。 一个QPen的属性总共有五种：线的格式，线的宽度，线的颜色，线的端点样式，以及线与线之间的链接方式。 其实线的绝大多数函数都是围绕这五个属性来使用的。 下面讲述线的五种属性： 1，Qt::PenStyle 是一个枚举类型，定义了线的种类，总共有以下几种： Qt::NoPen -
QPen
小小博客
08-04 1533
介绍 QPen(钢笔)是一个基本的图形对象，用于绘制直线、曲线或者轮廓画出矩形、椭圆形、多边形及其他形状等。 QPen的使用 import sys from PyQt5.QtWidgets import * from PyQt5.QtGui import * from PyQt5.QtCore import Qt class Drawing(QWidget): def __init__...
QT：QPen、QBrush、与图形抗锯齿的关联
qq_43441284的博客
02-26 970
QPen 是 Qt 框架中用于定义绘图时使用的画笔属性的类。在使用 QPainter 进行 2D 绘图时，QPen 可以控制线条的外观，比如线条的颜色、宽度、样式（如实线、虚线等）、端点样式（如方形端点、圆形端点等）和连接样式（如斜接、圆角连接等）。
Qt | QPen 类(画笔)
m0_45463480的博客
07-07 404
自定义虚线1)、 设置画笔的虚线图案(即自定义虚线的样式)，该函数必须指定偶数个正项，其中奇数项是破折号，偶数项是空格。 虚线图案的单位是以笔宽为单位的，比如，宽度为 11 像素，若设置其长度为 5，即 5 个笔宽单位这么长，因此短划线的长度为 5*11=55 像素。 注意：0 宽度相当于是 1 像素宽的装饰笔。 另外还要注意，端点样式也会影响虚线的长短，比如若端点样式为 Qt::SquareCap(默认值)，则会在线的端点处延长宽度的一半(详见正文)。
详解Qt 之 QPen与QBrush(画笔与画刷)
m0_62599305的博客
09-14 280
在 Qt 图形界面编程中，绘制图形是常见的操作。QPen和QBrush是 Qt 中用于图形绘制的两个基本类。QPen负责定义图形的边框样式，而QBrush用于填充图形的内部区域。理解这两个类的功能和用法可以帮助开发者实现丰富的图形绘制效果。本文将详细介绍QPen和QBrush的功能及其常用方法，并通过示例代码展示它们的实际应用。QPen和QBrush是 Qt 图形绘制中不可或缺的两个类。QPen用于设置图形的边框样式，包括颜色、宽度、线型等，而QBrush。
QT QPen 学习记录
热门推荐
漫步繁华街的专栏
02-10 1万+
使用QT很多年了，一直没有系统性的总结一下QPen，今天又全面复习总结一下。QPen 类定义了QPainter 应该怎样画线条和形状的轮廓。 对于QPen 画笔有以下几个重要特性。1.color(): 定义了线条的颜色。使用setColor(QColor(255, 0, 0, 100))定义画笔的颜色。2.width():定义了线条的宽度。使用setWidth(int width)设置线条的宽度。...
Qt中QPen类的使用
TechO_O的博客
09-05 539
使用QPen类之前，需要先创建一个QPainter对象，并将其关联到一个绘图设备（如QWidget或QImage）。它提供了一系列属性和方法，用于设置和控制绘制线条的样式、宽度、颜色等信息。由于之前已经设置了画笔，所以绘制的矩形将会使用之前设置的画笔属性我希望这篇文章对您有所帮助。由于之前已经设置了画笔，所以绘制的直线将会使用之前设置的画笔属性。除了设置颜色和宽度，QPen还提供了其他一些属性和方法，用于设置线条的样式、端点样式、连接样式等。接着，将该画笔对象设置给QPainter对象，以便在绘制时使用。
QPen方法功能（QT5.12）
For_1ove的博客
03-26 3588
//for starf study #include "mainwindow.h" #include "ui_mainwindow.h" #include<QDebug> #include<QBrush> #include <QPen> #include <QColor> //QPen类定义了QPainter应该如何绘制形状的线条和轮廓。 MainWindow::MainWindow(QWidget *parent) : QMainWindow.
Qt学习 第23节：QPen 和 QBrush
人类工程师的博客
12-28 1068
Constant Value Description Qt::white 3 White (#ffffff) Qt::black 2 Black (#000000) Qt::red 7 Red (#ff0000) Qt::darkRed 13 Dark red (#800000) Qt::green 8 Green (#00ff00) Qt::darkGreen 14 Dark green (#008
Qt QPen
qq_30150579的博客
10-09 270
QPen
Qt学习笔记13：外观设计（QBrush & QPen）
WHEgqing的专栏
06-23 1345
Qt中提供了强大的2D绘图系统，可以使用相同的API在屏幕上和绘图·设备上进行绘制，主要基于QPainter、QPainterDevice和QPainterEngine这3个类。QPainter执行绘图操作，QPainterDevice提供绘图设备，是一个二维空间的抽象，QPainterEngine提供一些接口。QPainter可以绘制一切简单的图形，从简单的一条直线到任何复杂的图形。QPainter类可以在一切继承QPainterDevice的子类上进行绘制操作。
QPen总结
name_jiaosa的博客
12-05 3440
QPen基本用法。
画笔 QPen
TemetNosce的博客
09-18 1040
qt
Go-Qt5开发之QPen(画笔)(37)
清风冷吟
03-23 562
Go-Qt5开发之QPen-画笔案例说明demo.go 案例说明 QPen是一个基本的图形对象。用于绘制线条、曲线和轮廓的矩形、椭圆、多边形或其他形状。 示例中我们画六行。线条勾勒出了六个不同的笔风格。有五个预定义的钢笔样式。 我们也可以创建自定义的钢笔样式。最后一行使用一个定制的钢笔绘制风格。 demo.go package main import ( "github.com...
qt qpen用法
05-31
QPen是Qt中的一个类，用于设置绘制图形的线条样式和颜色。下面是一些QPen的常用用法： 1. 创建一个QPen对象并设置线条颜色和宽度： ```cpp QPen pen(Qt::red); pen.setWidth(2); ``` 2. 设置线条样式： ```cpp pen.setStyle(Qt::DashDotLine); ``` 3. 设置线条末端样式： ```cpp pen.setCapStyle(Qt::RoundCap); ``` 4. 设置线条连接处样式： ```cpp pen.setJoinStyle(Qt::RoundJoin); ``` 5. 设置线条的斜接处： ```cpp pen.setMiterLimit(2.0); ``` 6. 获取当前线条颜色和宽度： ```cpp QColor color = pen.color(); int width = pen.width(); ``` 7. 绘制图形时使用该QPen对象： ```cpp painter.setPen(pen); painter.drawLine(0, 0, 100, 100); ``` 以上是QPen的一些常用用法，希望能对你有所帮助。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值