QPen Class

QPainter painter(this);
QPen pen(Qt::green, 3, Qt::DashDotLine, Qt::RoundCap, Qt::RoundJoin);
painter.setPen(pen);

QPainter painter(this);
QPen pen;  // creates a default pen

pen.setStyle(Qt::DashDotLine);
pen.setWidth(3);
pen.setBrush(Qt::green);
pen.setCapStyle(Qt::RoundCap);
pen.setJoinStyle(Qt::RoundJoin);

painter.setPen(pen);

QPen pen;
QList<qreal> dashes;
qreal space = 4;

dashes << 1 << space << 3 << space << 9 << space
           << 27 << space << 9 << space;

pen.setDashPattern(dashes);

멤버 함수 문서

QPen::QPen()

두께가 1인 기본 검은색 실선 펜을 생성합니다.

QPen::QPen(Qt::PenStyle style)

폭이 1이고 주어진 style 를 가진 검은색 펜을 생성합니다.

setStyle()도 참조하십시오 .

QPen::QPen(const QColor &color)

폭 1이고 주어진 color 를 갖는 실선 펜을 생성합니다.

setBrush() 및 setColor()도 참조하십시오 .

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

지정된 brush, width, pen style, cap 스타일 및 join 스타일을 가진 펜을 생성합니다.

setBrush(), setWidth(), setStyle(), setCapStyle() 및 setJoinStyle()도 참조하십시오 .

[noexcept] QPen::QPen(const QPen &pen)

주어진 ` pen`의 복사본인 펜을 생성합니다.

[constexpr noexcept default] QPen::QPen(QPen &&pen)

지정된 pen 에서 이동된 펜을 생성합니다.

moved-from 펜은 할당, 복사 또는 소멸만 가능합니다. (할당 이전에) 그 외의 모든 작업은 정의되지 않은 동작을 초래합니다.

[noexcept] QPen::~QPen()

펜을 부숴 버린다.

QBrush QPen::brush() const

이 펜으로 생성된 획을 채우는 데 사용된 브러시를 반환합니다.

setBrush()도 참조하십시오 .

Qt::PenCapStyle QPen::capStyle() const

펜 캡의 스타일을 반환합니다.

setCapStyle() 및 Cap Style도 참조하십시오 .

QColor QPen::color() const

이 펜의 브러시 색상을 반환합니다.

brush() 및 setColor()도 참조하십시오 .

qreal QPen::dashOffset() const

펜의 대시 오프셋을 반환합니다.

setDashOffset()도 참조하십시오 .

QList<qreal> QPen::dashPattern() const

이 펜의 대시 패턴을 반환합니다.

setDashPattern(), style(), isSolid()도 참조하십시오 .

bool QPen::isCosmetic() const

펜이 코스메틱 펜인 경우 ` true `을 반환하고, 그렇지 않은 경우 ` false`을 반환합니다.

코스메틱 펜은 함께 사용되는 QPainter 에 어떤 변환이 적용되더라도 일정한 너비를 가진 선을 그리는 데 사용됩니다. 코스메틱 펜으로 도형을 그리면 다양한 배율에서 도형의 윤곽선 두께가 동일하게 유지됩니다.

폭이 0인 펜은 기본적으로 장식용입니다.

setCosmetic() 및 widthF()도 참조하십시오 .

bool QPen::isSolid() const

펜에 단색 채우기가 설정되어 있으면 true 를 반환하고, 그렇지 않으면 false를 반환합니다.

style() 및 dashPattern()도 참조하십시오 .

Qt::PenJoinStyle QPen::joinStyle() const

펜의 연결 스타일을 반환합니다.

setJoinStyle() 및 Join Style도 참조하십시오 .

qreal QPen::miterLimit() const

펜의 마이터 제한값을 반환합니다. 마이터 제한값은 조인 스타일이 ‘ Qt::MiterJoin ’로 설정된 경우에만 적용됩니다.

setMiterLimit() 및 Join Style도 참조하십시오 .

void QPen::setBrush(const QBrush &brush)

이 펜으로 생성된 획을 채우는 데 사용되는 브러시를 지정된 brush 로 설정합니다.

brush() 및 setColor()도 참조하십시오 .

void QPen::setCapStyle(Qt::PenCapStyle style)

펜 캡 스타일을 지정된 style 로 설정합니다. 기본값은 Qt::SquareCap 입니다.

capStyle() 및 Cap Style도 참조하십시오 .

void QPen::setColor(const QColor &color)

이 펜의 브러시 색상을 지정된 color 로 설정합니다.

setBrush() 및 color()도 참조하십시오 .

void QPen::setCosmetic(bool cosmetic)

cosmetic 의 값에 따라 이 펜을 ‘cosmetic’ 또는 ‘non-cosmetic’으로 설정합니다.

isCosmetic()도 참조하십시오 .

void QPen::setDashOffset(qreal offset)

이 펜의 대시 오프셋(대시 패턴의 시작점)을 지정된 offset 값으로 설정합니다. 오프셋은 대시 패턴을 지정하는 데 사용된 단위를 기준으로 측정됩니다.

dashOffset()도 참조하십시오 .

void QPen::setDashPattern(const QList<qreal> &pattern)

이 펜의 대시 패턴을 지정된 ` pattern`로 설정합니다. 이렇게 하면 펜의 스타일이 암묵적으로 ` Qt::CustomDashLine`로 변환됩니다.

패턴은 짝수 개의 양수 항목으로 지정해야 하며, 여기서 1, 3, 5…번 항목은 대시이고 2, 4, 6…번 항목은 공백입니다. 예를 들면:

대시 패턴은 펜의 너비 단위로 지정됩니다. 예를 들어, 너비 10인 펜에서 길이 5의 대시는 50픽셀 길이가 됩니다. 너비가 0인 펜은 너비가 1픽셀인 장식용 펜과 동일하다는 점에 유의하십시오.

각 대시에는 끝단 스타일이 적용되므로, 사각 끝단이 설정된 길이 1의 대시는 각 방향으로 0.5 픽셀씩 확장되어 총 너비가 2가 됩니다.

기본 캡 스타일은 ‘ Qt::SquareCap ’이며, 이는 사각형 선 끝이 끝점을 덮고 선 너비의 절반만큼 끝점을 넘어 확장됨을 의미합니다.

setStyle(), dashPattern(), setCapStyle() 및 setCosmetic()도 참조하십시오 .

void QPen::setJoinStyle(Qt::PenJoinStyle style)

펜의 연결 스타일을 지정된 style 로 설정합니다. 기본값은 Qt::BevelJoin 입니다.

joinStyle() 및 Join Style도 참조하십시오 .

void QPen::setMiterLimit(qreal limit)

이 펜의 마이터 제한을 지정된 값 limit 로 설정합니다.

마이터 제한은 마이터 접합부가 접합점에서 얼마나 멀리 뻗어 나갈 수 있는지를 나타냅니다. 이 기능은 선들이 거의 평행한 경우 선 접합부 사이의 아티팩트를 줄이는 데 사용됩니다.

이 값은 펜 스타일이 ` Qt::MiterJoin`로 설정된 경우에만 적용됩니다. 값은 펜 너비 단위로 지정되며, 예를 들어 너비가 10인 펜에서 마이터 제한값이 5인 경우 길이는 50픽셀이 됩니다. 기본 마이터 제한값은 2이며, 이는 픽셀 단위로 펜 너비의 두 배에 해당합니다.

miterLimit(), setJoinStyle() 및 Join Style도 참조하십시오 .

void QPen::setStyle(Qt::PenStyle style)

펜 스타일을 지정된 style 로 설정합니다.

사용 가능한 스타일 목록은 Qt::PenStyle 문서를 참조하십시오. Qt 4.1부터는 setDashPattern() 함수를 사용하여 사용자 정의 대시 패턴을 지정할 수도 있으며, 이 함수는 펜의 스타일을 암시적으로 Qt::CustomDashLine 로 변환합니다.

style() 및 Pen Style도 참조하십시오 .

void QPen::setWidth(int width)

펜 너비를 지정된 width 값(픽셀 단위)으로 정수 정밀도로 설정합니다.

선 너비가 0이면 장식용 펜을 의미합니다. 이는 페인터에 설정된 transformation 와 관계없이 펜 너비가 항상 1픽셀로 그려진다는 것을 의미합니다.

음수 값으로 펜 너비를 설정하는 것은 지원되지 않습니다.

setWidthF() 및 width()도 참조하십시오 .

void QPen::setWidthF(qreal width)

펜 너비를 부동 소수점 정밀도로 주어진 width (픽셀 단위)로 설정합니다.

선 너비가 0이면 장식용 펜을 의미합니다. 즉, 페인터의 transformation 설정과 관계없이 펜 너비는 항상 1픽셀로 그려집니다.

음수 값으로 펜 너비를 설정하는 것은 지원되지 않습니다.

setWidth() 및 widthF()도 참조하십시오 .

Qt::PenStyle QPen::style() const

펜 스타일을 반환합니다.

setStyle() 및 Pen Style도 참조하십시오 .

[noexcept] void QPen::swap(QPen &other)

이 펜을 other 로 교체합니다. 이 작업은 매우 빠르며 절대 실패하지 않습니다.

int QPen::width() const

펜 너비를 정수 정밀도로 반환합니다.

setWidth() 및 widthF()도 참조하십시오 .

qreal QPen::widthF() const

부동 소수점 정밀도로 펜 너비를 반환합니다.

setWidthF() 및 width()도 참조하십시오 .

QPen::operator QVariant() const

펜을 ` QVariant` 객체로 반환합니다.

bool QPen::operator!=(const QPen &pen) const

펜이 지정된 pen 와 다르면 true 를 반환하고, 그렇지 않으면 false를 반환합니다. 두 펜의 스타일, 두께 또는 색상이 다르면 서로 다른 것으로 간주됩니다.

operator==()도 참조하십시오 .

[noexcept] QPen &QPen::operator=(QPen &&other)

other 를 이 QPen 인스턴스에 할당합니다.

[noexcept] QPen &QPen::operator=(const QPen &pen)

지정된 ` pen `를 이 펜에 할당하고, 이 펜에 대한 참조를 반환합니다.

[since 6.9] QPen &QPen::operator=(QColor color)

이 펜을 지정된 색상과 기본 캡 및 연결 스타일로 설정하고, 이 펜에 대한 참조를 반환합니다.

이 함수는 Qt 6.9에서 도입되었습니다.

[since 6.9] QPen &QPen::operator=(Qt::PenStyle style)

이 펜을 기본 캡 및 연결 스타일을 가진 단색 검정색 펜으로 만들고, 이 펜에 대한 참조를 반환합니다.

이 함수는 Qt 6.9에서 도입되었습니다.

bool QPen::operator==(const QPen &pen) const

펜이 주어진 pen 와 같으면 true 를 반환하고, 그렇지 않으면 false를 반환합니다. 두 펜은 스타일, 너비, 색상이 모두 같을 때 서로 같다고 간주됩니다.

operator!=()도 참조하십시오 .