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);

Documentation des fonctions membres

QPen::QPen()

Crée un stylo par défaut représentant une ligne continue noire d'une largeur de 1.

QPen::QPen(Qt::PenStyle style)

Crée un stylo noir d'une largeur de 1 et dont la couleur est définie par l'style.

Voir aussi setStyle().

QPen::QPen(const QColor &color)

Crée un trait continu d'une largeur égale à 1 et selon l'color, comme indiqué.

Voir également setBrush() et setColor().

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

Crée un stylo avec les propriétés suivantes : brush, width, pen style, cap style et join style.

Voir également setBrush(), setWidth(), setStyle(), setCapStyle() et setJoinStyle().

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

Crée un stylo qui est une copie de l'pen.

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

Crée un stylo déplacé depuis l'pen ion indiquée.

Le stylo d'origine ne peut être que affecté, copié ou détruit. Toute autre opération (avant l'affectation) entraîne un comportement indéfini.

[noexcept] QPen::~QPen()

Il détruit le stylo.

QBrush QPen::brush() const

Renvoie le pinceau utilisé pour remplir les traits générés avec ce stylo.

Voir aussi setBrush().

Qt::PenCapStyle QPen::capStyle() const

Renvoie le style du capuchon du stylo.

Voir également setCapStyle() et Cap Style.

QColor QPen::color() const

Renvoie la couleur du pinceau de ce stylo.

Voir également brush() et setColor().

qreal QPen::dashOffset() const

Renvoie le décalage du tiret pour le stylo.

Voir également setDashOffset().

QList<qreal> QPen::dashPattern() const

Renvoie le motif de tirets de ce stylo.

Voir également setDashPattern(), style() et isSolid().

bool QPen::isCosmetic() const

Renvoie true si le stylo est de type « cosmetic » ; sinon, renvoie false.

Les stylos « cosmétiques » sont utilisés pour tracer des traits dont la largeur reste constante, quelles que soient les transformations appliquées à l'QPainter avec laquelle ils sont utilisés. Dessiner une forme avec un stylo « cosmétique » garantit que son contour aura la même épaisseur, quel que soit le facteur d'échelle.

Un stylo de largeur nulle est cosmétique par défaut.

Voir également setCosmetic() et widthF().

bool QPen::isSolid() const

Renvoie true si le stylo a un remplissage uni, sinon false.

Voir également style() et dashPattern().

Qt::PenJoinStyle QPen::joinStyle() const

Renvoie le style de jonction du trait.

Voir également setJoinStyle() et Join Style.

qreal QPen::miterLimit() const

Renvoie la limite d'onglet du trait. La limite d'onglet n'est pertinente que lorsque le style de jonction est défini sur « Qt::MiterJoin ».

Voir également setMiterLimit() et Join Style.

void QPen::setBrush(const QBrush &brush)

Définit le pinceau utilisé pour remplir les traits générés avec ce stylo sur l'brush spécifiée.

Voir également brush() et setColor().

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

Définit le style du capuchon du stylo sur la valeur indiquée style. La valeur par défaut est Qt::SquareCap.

Voir également capStyle() et Cap Style.

void QPen::setColor(const QColor &color)

Définit la couleur du pinceau de ce stylo selon l'color indiquée.

Voir également setBrush() et color().

void QPen::setCosmetic(bool cosmetic)

Définit ce stylo comme « cosmétique » ou « non cosmétique », en fonction de la valeur de cosmetic.

Voir également isCosmetic().

void QPen::setDashOffset(qreal offset)

Définit le décalage du trait (le point de départ du motif de trait) pour ce stylo à l'offset e spécifiée. Le décalage est mesuré en unités utilisées pour définir le motif de trait.

Voir également dashOffset().

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

Définit le motif de tirets de ce stylo selon l'pattern. Cela convertit implicitement le style du stylo en Qt::CustomDashLine.

Le motif doit être spécifié sous la forme d’un nombre pair d’entrées positives, où les entrées 1, 3, 5… correspondent aux traits et les entrées 2, 4, 6… aux espaces. Par exemple :

Le motif de tirets est spécifié en unités correspondant à la largeur des stylos ; par exemple, un tiret de longueur 5 et de largeur 10 mesure 50 pixels de long. Notez qu’un stylo de largeur nulle équivaut à un stylo cosmétique d’une largeur de 1 pixel.

Chaque tiret est également soumis à des styles d'extrémités ; ainsi, un tiret de longueur 1 avec des extrémités carrées s'étendra de 0,5 pixel dans chaque direction, ce qui donne une largeur totale de 2.

Notez que le style d’extrémité par défaut est « Qt::SquareCap », ce qui signifie qu’une extrémité carrée recouvre le point d’extrémité et s’étend au-delà de celui-ci de la moitié de la largeur de la ligne.

Voir également setStyle(), dashPattern(), setCapStyle() et setCosmetic().

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

Définit le style de jonction du trait sur la valeur indiquée : style. La valeur par défaut est Qt::BevelJoin.

Voir également joinStyle() et Join Style.

void QPen::setMiterLimit(qreal limit)

Définit la limite d'onglet de ce stylo à la valeur indiquée limit.

La limite de chanfrein définit jusqu'où un raccord en chanfrein peut s'étendre à partir du point de jonction. Elle permet de réduire les artefacts entre les jonctions de lignes lorsque celles-ci sont presque parallèles.

Cette valeur n’a d’effet que lorsque le style de stylo est défini sur « Qt::MiterJoin ». La valeur est spécifiée en unités correspondant à la largeur du stylo ; par exemple, une limite de mitre de 5 pour une largeur de 10 correspond à une longueur de 50 pixels. La limite de mitre par défaut est de 2, c’est-à-dire deux fois la largeur du stylo en pixels.

Voir également miterLimit(), setJoinStyle() et Join Style.

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

Définit le style du trait sur la valeur indiquée dans ` style`.

Consultez la documentation d'Qt::PenStyle pour obtenir la liste des styles disponibles. Depuis Qt 4.1, il est également possible de spécifier un motif de tirets personnalisé à l'aide de la fonction setDashPattern(), qui convertit implicitement le style du stylo en Qt::CustomDashLine.

Voir également style() et Pen Style.

void QPen::setWidth(int width)

Définit la largeur du stylo à l'width spécifiée en pixels, avec une précision entière.

Une largeur de trait égale à zéro indique un stylo décoratif. Cela signifie que la largeur du trait est toujours de un pixel, quelle que soit l'transformation définie sur l'outil de dessin.

La définition d’une largeur de stylo avec une valeur négative n’est pas prise en charge.

Voir également ` setWidthF()` et ` width()`.

void QPen::setWidthF(qreal width)

Définit la largeur du stylo selon l'width fournie en pixels, avec une précision en virgule flottante.

Une largeur de trait égale à zéro correspond à un stylo décoratif. Cela signifie que la largeur du trait est toujours de un pixel, quelle que soit l'transformation définie sur le peintre.

La définition d’une largeur de stylo avec une valeur négative n’est pas prise en charge.

Voir également setWidth() et widthF().

Qt::PenStyle QPen::style() const

Renvoie le style du stylo.

Voir également setStyle() et Pen Style.

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

Échangez ce stylo contre other. Cette opération est très rapide et fonctionne à coup sûr.

int QPen::width() const

Renvoie la largeur du stylo avec une précision entière.

Voir également setWidth() et widthF().

qreal QPen::widthF() const

Renvoie la largeur du stylo avec une précision en virgule flottante.

Voir également setWidthF() et width().

QPen::operator QVariant() const

Renvoie le stylo sous la forme d'un objet ` QVariant`.

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

Renvoie « true » si le stylo est différent de celui indiqué par ` pen` ; sinon, renvoie « false ». Deux stylos sont considérés comme différents s'ils ont des styles, des largeurs ou des couleurs différents.

Voir aussi operator==().

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

Cette opération attribue l'other à cette instance QPen.

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

Attribue l'pen on indiquée à ce stylo et renvoie une référence à ce stylo.

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

Crée un stylo de type « solide » avec la couleur indiquée, ainsi que les styles par défaut pour le capuchon et la jonction, puis renvoie une référence à ce stylo.

Cette fonction a été introduite dans Qt 6.9.

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

Transforme ce stylo en un stylo noir uni avec les styles de capuchon et de raccord par défaut, puis renvoie une référence à ce stylo.

Cette fonction a été introduite dans Qt 6.9.

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

Renvoie « true » si le stylo est égal à celui indiqué par ` pen` ; sinon, renvoie « false ». Deux stylos sont égaux s'ils ont les mêmes styles, largeurs et couleurs.

Voir aussi operator!=().