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 sur les fonctions membres

QPen::QPen()

Construit un stylo noir à ligne pleine par défaut avec une largeur de 1.

QPen::QPen(Qt::PenStyle style)

Construit un stylo noir avec une largeur de 1 et la valeur donnée style.

Voir aussi setStyle().

QPen::QPen(const QColor &color)

Construit un stylo à ligne pleine avec une largeur de 1 et la valeur donnée color.

Voir aussi 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)

Construit un stylo avec les styles spécifiés brush, width, stylo style, cap et join.

Voir aussi setBrush(), setWidth(), setStyle(), setCapStyle() et setJoinStyle().

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

Construit un stylo qui est une copie du stylo donné pen.

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

Construit un stylo qui est déplacé à partir de l'adresse pen.

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

[noexcept] QPen::~QPen()

Détruit le stylo.

QBrush QPen::brush() const

Renvoie la brosse utilisée pour remplir les traits générés avec ce stylo.

Voir également setBrush().

Qt::PenCapStyle QPen::capStyle() const

Renvoie le style de capuchon du stylo.

Voir aussi setCapStyle() et Cap Style.

QColor QPen::color() const

Renvoie la couleur de la brosse de ce stylo.

Voir aussi brush() et setColor().

qreal QPen::dashOffset() const

Renvoie le décalage du tiret pour le stylo.

Voir aussi setDashOffset().

QList<qreal> QPen::dashPattern() const

Renvoie le motif de tirets de ce stylo.

Voir aussi setDashPattern(), style() et isSolid().

bool QPen::isCosmetic() const

Renvoie true si le stylo est cosmétique, sinon renvoie false.

Les stylos cosmétiques sont utilisés pour dessiner des traits qui ont une largeur constante, quelles que soient les transformations appliquées au site QPainter avec lequel ils sont utilisés. Le fait de dessiner une forme avec un stylo cosmétique garantit que son contour aura la même épaisseur à différents facteurs 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 solide, sinon false.

Voir aussi style() et dashPattern().

Qt::PenJoinStyle QPen::joinStyle() const

Renvoie le style de jointure du stylo.

Voir aussi setJoinStyle() et Join Style.

qreal QPen::miterLimit() const

Renvoie la limite d'onglet du stylo. La limite d'onglet n'est pertinente que lorsque le style de jointure est défini sur Qt::MiterJoin.

Voir également setMiterLimit() et Join Style.

void QPen::setBrush(const QBrush &brush)

Définit la brosse utilisée pour remplir les traits générés avec ce stylo à l'adresse brush.

Voir également brush() et setColor().

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

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

Voir aussi capStyle() et Cap Style.

void QPen::setColor(const QColor &color)

Définit la couleur de la brosse de ce stylo à la valeur donnée color.

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 tiret (le point de départ du motif du tiret) pour ce stylo à l'adresse offset spécifiée. Le décalage est mesuré en termes d'unités utilisées pour spécifier le motif du tiret.

Voir également dashOffset().

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

Définit le motif du tiret pour ce stylo à la valeur donnée 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... sont les tirets et 2, 4, 6... sont les espaces. Par exemple, le motif du tiret est spécifié en unités positives :

Le motif du tiret est spécifié en unités de la largeur du stylo ; par exemple, un tiret de longueur 5 dans une largeur de 10 a une longueur de 50 pixels. Notez qu'un stylo de largeur nulle est équivalent à un stylo cosmétique d'une largeur de 1 pixel.

Chaque tiret est également soumis aux styles de capuchon. Ainsi, un tiret de 1 avec un capuchon carré s'étendra de 0,5 pixel dans chaque direction, ce qui donne une largeur totale de 2.

Notez que le style de chapeau par défaut est Qt::SquareCap, ce qui signifie que l'extrémité d'une ligne carrée couvre le point final et le dépasse 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 jointure du stylo à la valeur donnée style. La valeur par défaut est Qt::BevelJoin.

Voir aussi joinStyle() et Join Style.

void QPen::setMiterLimit(qreal limit)

Fixe la limite d'onglet de ce stylo à la valeur donnée limit.

La limite d'onglet décrit la distance à laquelle une jonction d'onglet peut s'étendre à partir du point de jonction. Elle est utilisée pour réduire les artefacts entre les jonctions de lignes lorsque les lignes 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 de largeur du stylo, par exemple une limite d'onglet de 5 dans une largeur de 10 correspond à une longueur de 50 pixels. La limite d'onglet 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 de stylo à l'adresse style.

Voir la documentation Qt::PenStyle pour une liste des styles disponibles. Depuis Qt XML 4.1, il est également possible de spécifier un motif de tiret personnalisé en utilisant la fonction setDashPattern() qui convertit implicitement le style du stylo en Qt::CustomDashLine.

Voir également style() et Pen Style.

void QPen::setWidth(int width)

Fixe la largeur du stylo à la valeur donnée width en pixels avec une précision entière.

Une largeur de ligne de zéro indique un stylo cosmétique. Cela signifie que la largeur du stylo est toujours d'un pixel de large, indépendamment de l'adresse 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 setWidthF() et width().

void QPen::setWidthF(qreal width)

Fixe la largeur du stylo à la valeur donnée width en pixels avec une précision en virgule flottante.

Une largeur de ligne de zéro indique un stylo cosmétique. Cela signifie que la largeur du stylo est toujours d'un pixel de large, indépendamment de l'adresse transformation du 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 de stylo.

Voir aussi setStyle() et Pen Style.

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

Remplace ce stylo par other. Cette opération est très rapide et n'échoue jamais.

int QPen::width() const

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

Voir aussi setWidth() et widthF().

qreal QPen::widthF() const

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

Voir aussi setWidthF() et width().

QPen::operator QVariant() const

Retourne le stylo sous forme de QVariant.

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

Renvoie true si le stylo est différent du stylo donné pen; sinon false. Deux stylos sont différents s'ils ont des styles, des largeurs ou des couleurs différents.

Voir aussi operator==().

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

Move-assigne other à cette instance QPen.

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

Affecte le site pen à ce stylo et renvoie une référence à ce stylo.

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

Fait de ce stylo un stylo solide avec la couleur donnée et les styles de capuchon et de jointure par défaut, et 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)

Fait de ce stylo un stylo noir solide avec les styles de capuchon et de jointure par défaut, et 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 au stylo donné pen; sinon false. Deux stylos sont égaux s'ils ont les mêmes styles, largeurs et couleurs.

Voir aussi operator!=().