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

Documentación de funciones miembro

QPen::QPen()

Construye una pluma de línea sólida negra predeterminada con 1 de ancho.

QPen::QPen(Qt::PenStyle style)

Construye un bolígrafo negro con 1 de ancho y la dirección style.

Véase también setStyle().

QPen::QPen(const QColor &color)

Construye un lápiz de línea sólida con 1 de ancho y la dirección color.

Véase también setBrush() y setColor().

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

Construye un bolígrafo con los estilos brush, width, bolígrafo style, cap y join especificados.

Véase también setBrush(), setWidth(), setStyle(), setCapStyle() y setJoinStyle().

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

Construye un bolígrafo que es una copia del dado pen.

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

Construye un bolígrafo que se mueve desde la dirección pen.

El bolígrafo movido desde sólo puede ser asignado, copiado o destruido. Cualquier otra operación (antes de la asignación) conduce a un comportamiento indefinido.

[noexcept] QPen::~QPen()

Destruye la pluma.

QBrush QPen::brush() const

Devuelve el pincel utilizado para rellenar los trazos generados con esta pluma.

Véase también setBrush().

Qt::PenCapStyle QPen::capStyle() const

Devuelve el estilo del capuchón del bolígrafo.

Véase también setCapStyle() y Cap Style.

QColor QPen::color() const

Devuelve el color del pincel de este rotulador.

Véase también brush() y setColor().

qreal QPen::dashOffset() const

Devuelve el desplazamiento del guión de la pluma.

Véase también setDashOffset().

QList<qreal> QPen::dashPattern() const

Devuelve el patrón de guiones de este bolígrafo.

Véase también setDashPattern(), style() y isSolid().

bool QPen::isCosmetic() const

Devuelve true si la pluma es cosmética; en caso contrario devuelve false.

Los lápices cosméticos se utilizan para dibujar trazos que tienen una anchura constante independientemente de las transformaciones aplicadas a QPainter con las que se utilizan. Dibujar una forma con un lápiz cosmético asegura que su contorno tendrá el mismo grosor a diferentes factores de escala.

Un lápiz de anchura cero es cosmético por defecto.

Véase también setCosmetic() y widthF().

bool QPen::isSolid() const

Devuelve true si el lápiz tiene un relleno sólido, en caso contrario false.

Véase también style() y dashPattern().

Qt::PenJoinStyle QPen::joinStyle() const

Devuelve el estilo de unión de la pluma.

Véase también setJoinStyle() y Join Style.

qreal QPen::miterLimit() const

Devuelve el límite de inglete de la pluma. El límite de inglete sólo es relevante cuando el estilo de unión se establece en Qt::MiterJoin.

Véase también setMiterLimit() y Join Style.

void QPen::setBrush(const QBrush &brush)

Establece el pincel utilizado para rellenar los trazos generados con este lápiz en la dirección brush.

Véase también brush() y setColor().

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

Establece el estilo del capuchón del bolígrafo en style. El valor por defecto es Qt::SquareCap.

Véase también capStyle() y Cap Style.

void QPen::setColor(const QColor &color)

Establece el color del pincel de este bolígrafo en la dirección color.

Véase también setBrush() y color().

void QPen::setCosmetic(bool cosmetic)

Establece este bolígrafo como cosmético o no cosmético, dependiendo del valor de cosmetic.

Véase también isCosmetic().

void QPen::setDashOffset(qreal offset)

Establece el desplazamiento del guión (el punto de inicio del patrón de guiones) para este bolígrafo en offset especificado. El desplazamiento se mide en términos de las unidades utilizadas para especificar el patrón de guiones.

Véase también dashOffset().

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

Establece el patrón de guiones de este bolígrafo en la dirección pattern. Esto convierte implícitamente el estilo de la pluma a Qt::CustomDashLine.

El patrón debe especificarse como un número par de entradas positivas donde las entradas 1, 3, 5... son los guiones y 2, 4, 6... son los espacios. Por ejemplo:

El patrón de guiones se especifica en unidades de la anchura de la pluma; por ejemplo, un guión de longitud 5 en anchura 10 tiene una longitud de 50 píxeles. Tenga en cuenta que una pluma con anchura cero equivale a una pluma cosmética con una anchura de 1 píxel.

Cada guión también está sujeto a los estilos de tapa, por lo que un guión de 1 con tapa cuadrada se extenderá 0,5 píxeles en cada dirección, lo que resulta en una anchura total de 2.

Tenga en cuenta que el estilo de remate por defecto es Qt::SquareCap, lo que significa que un final de línea cuadrado cubre el punto final y se extiende más allá de él la mitad del ancho de la línea.

Véase también setStyle(), dashPattern(), setCapStyle() y setCosmetic().

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

Establece el estilo de unión del bolígrafo en style. El valor por defecto es Qt::BevelJoin.

Véase también joinStyle() y Join Style.

void QPen::setMiterLimit(qreal limit)

Establece el límite de inglete de esta pluma en la dirección limit.

El límite de inglete describe hasta dónde puede extenderse una unión de inglete desde el punto de unión. Esto se utiliza para reducir los artefactos entre las uniones de líneas donde las líneas son casi paralelas.

Este valor sólo tiene efecto cuando el estilo de pluma es Qt::MiterJoin. El valor se especifica en unidades de la anchura de la pluma, por ejemplo, un límite de inglete de 5 en anchura 10 es 50 píxeles de largo. El límite de inglete por defecto es 2, es decir, el doble de la anchura de la pluma en píxeles.

Véase también miterLimit(), setJoinStyle(), y Join Style.

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

Establece el estilo de la pluma en style.

Consulte la documentación de Qt::PenStyle para obtener una lista de los estilos disponibles. Desde Qt 4.1 también es posible especificar un patrón de guión personalizado usando la función setDashPattern() que implícitamente convierte el estilo del bolígrafo a Qt::CustomDashLine.

Véase también style() y Pen Style.

void QPen::setWidth(int width)

Establece la anchura de la pluma en width en píxeles con precisión entera.

Un ancho de línea de cero indica una pluma cosmética. Esto significa que el ancho de la pluma siempre se dibuja con un píxel de ancho, independientemente de transformation establecido en el pintor.

No se admite establecer un ancho de pluma con un valor negativo.

Véase también setWidthF() y width().

void QPen::setWidthF(qreal width)

Establece la anchura de la pluma en width en píxeles con precisión de coma flotante.

Un ancho de línea de cero indica una pluma cosmética. Esto significa que el ancho de la pluma siempre se dibuja con un píxel de ancho, independientemente de transformation en el pintor.

No se admite la configuración de un ancho de pluma con un valor negativo.

Véase también setWidth() y widthF().

Qt::PenStyle QPen::style() const

Devuelve el estilo de la pluma.

Véase también setStyle() y Pen Style.

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

Cambia este bolígrafo por other. Esta operación es muy rápida y nunca falla.

int QPen::width() const

Devuelve el ancho de la pluma con precisión entera.

Véase también setWidth() y widthF().

qreal QPen::widthF() const

Devuelve el ancho de la pluma con precisión de coma flotante.

Véase también setWidthF() y width().

QPen::operator QVariant() const

Devuelve el bolígrafo como QVariant.

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

Devuelve true si la pluma es diferente de la dada pen; en caso contrario false. Dos bolígrafos son diferentes si tienen estilos, anchos o colores diferentes.

Véase también operator==().

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

Mover-asigna other a esta instancia QPen.

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

Asigna el pen dado a este bolígrafo y devuelve una referencia a este bolígrafo.

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

Convierte este bolígrafo en un bolígrafo sólido con el color dado y los estilos de tapa y junta predeterminados, y devuelve una referencia a este bol ígrafo.

Esta función se introdujo en Qt 6.9.

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

Convierte este bolígrafo en un bolígrafo negro sólido con los estilos de tapa y junta predeterminados, y devuelve una referencia a este bolígrafo.

Esta función se introdujo en Qt 6.9.

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

Devuelve true si la pluma es igual a la dada pen; en caso contrario false. Dos plumas son iguales si tienen estilos, anchos y colores iguales.

Véase también operator!=().