En esta página

QPainterPathStroker Class

La clase QPainterPathStroker se utiliza para generar contornos rellenables para una ruta de pintor dada. Más...

Cabecera: #include <QPainterPathStroker>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

Funciones Públicas

QPainterPathStroker()
QPainterPathStroker(const QPen &pen)
~QPainterPathStroker()
Qt::PenCapStyle capStyle() const
QPainterPath createStroke(const QPainterPath &path) const
qreal curveThreshold() const
qreal dashOffset() const
QList<qreal> dashPattern() const
Qt::PenJoinStyle joinStyle() const
qreal miterLimit() const
void setCapStyle(Qt::PenCapStyle style)
void setCurveThreshold(qreal threshold)
void setDashOffset(qreal offset)
void setDashPattern(Qt::PenStyle style)
void setDashPattern(const QList<qreal> &dashPattern)
void setJoinStyle(Qt::PenJoinStyle style)
void setMiterLimit(qreal limit)
void setWidth(qreal width)
qreal width() const

Descripción Detallada

Al llamar a la función createStroke(), pasando un QPainterPath dado como argumento, se crea un nuevo trazado de pintor que representa el contorno del trazado dado. El nuevo trazado puede rellenarse para dibujar el contorno del trazado original.

Puede controlar los distintos aspectos del diseño (anchura, estilos de tapa, estilos de unión y patrón de guiones) del contorno utilizando las siguientes funciones:

La función setDashPattern() acepta como argumento un objeto Qt::PenStyle y una representación en forma de lista del patrón.

Además, puede especificar el umbral de una curva, controlando la granularidad con la que se dibuja una curva, utilizando la función setCurveThreshold(). El umbral por defecto es un valor bien ajustado (0,25), y normalmente no debería ser necesario modificarlo. Sin embargo, puede hacer que el aspecto de la curva sea más suave disminuyendo su valor.

También puede controlar el límite de inglete para el contorno generado utilizando la función setMiterLimit(). El límite de inglete describe a qué distancia de cada junta puede extenderse la junta de inglete. El límite se especifica en unidades de anchura, por lo que el límite de inglete en píxeles será miterlimit * width. Este valor sólo se utiliza si el estilo de unión es Qt::MiterJoin.

El trazado de pintor generado por la función createStroke() sólo debe utilizarse para contornear el trazado de pintor dado. De lo contrario, puede provocar un comportamiento inesperado. Los contornos generados también requieren la regla Qt::WindingFill que se establece por defecto.

Véase también QPen y QBrush.

Documentación de las funciones miembro

QPainterPathStroker::QPainterPathStroker()

Crea un nuevo stroker.

[explicit] QPainterPathStroker::QPainterPathStroker(const QPen &pen)

Crea un nuevo stroker basado en pen.

[noexcept] QPainterPathStroker::~QPainterPathStroker()

Destruye el stroker.

Qt::PenCapStyle QPainterPathStroker::capStyle() const

Devuelve el estilo de tapa de los contornos generados.

Véase también setCapStyle().

QPainterPath QPainterPathStroker::createStroke(const QPainterPath &path) const

Genera un nuevo trazado que es un área rellenable que representa el contorno del path dado.

Los distintos aspectos de diseño del contorno se basan en las propiedades del trazador: width(), capStyle(), joinStyle(), dashPattern(), curveThreshold() y miterLimit().

El trazado generado sólo debe utilizarse para contornear el trazado del pintor dado. De lo contrario, puede provocar un comportamiento inesperado. Los contornos generados también requieren la regla Qt::WindingFill que está establecida por defecto.

qreal QPainterPathStroker::curveThreshold() const

Devuelve el umbral de aplanamiento de curvas para los contornos generados.

Véase también setCurveThreshold().

qreal QPainterPathStroker::dashOffset() const

Devuelve el desplazamiento del guión para los contornos generados.

Véase también setDashOffset().

QList<qreal> QPainterPathStroker::dashPattern() const

Devuelve el patrón de guiones para los contornos generados.

Véase también setDashPattern().

Qt::PenJoinStyle QPainterPathStroker::joinStyle() const

Devuelve el estilo de unión de los contornos generados.

Véase también setJoinStyle().

qreal QPainterPathStroker::miterLimit() const

Devuelve el límite de inglete para los contornos generados.

Véase también setMiterLimit().

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

Establece el estilo de remate de los contornos generados en style. Si se establece un patrón de guiones, cada segmento del patrón estará sujeto al remate style.

Véase también capStyle().

void QPainterPathStroker::setCurveThreshold(qreal threshold)

Especifica el aplanamiento de la curva threshold, controlando la granularidad con la que se dibuja la curva de los contornos generados.

El umbral por defecto es un valor bien ajustado (0,25), y normalmente no debería necesitar modificarlo. Sin embargo, puede hacer que el aspecto de la curva sea más suave disminuyendo su valor.

Véase también curveThreshold().

void QPainterPathStroker::setDashOffset(qreal offset)

Establece el desplazamiento del guión para los contornos generados en offset.

Consulte la documentación de QPen::setDashOffset() para obtener una descripción del desplazamiento del guión.

Véase también dashOffset().

void QPainterPathStroker::setDashPattern(Qt::PenStyle style)

Establece el patrón de guiones para los contornos generados en style.

Véase también dashPattern().

void QPainterPathStroker::setDashPattern(const QList<qreal> &dashPattern)

Establece el patrón de guiones para los contornos generados en dashPattern. Esta función permite especificar patrones de guiones personalizados.

Cada elemento de la lista contiene las longitudes de los guiones y espacios del trazo, empezando por el primer guión del primer elemento, el primer espacio del segundo elemento y alternando entre guiones y espacios para cada par de elementos siguiente.

La lista puede contener un número impar de elementos, en cuyo caso el último elemento se ampliará en la longitud del primer elemento cuando se repita el patrón.

Se trata de una función sobrecargada.

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

Establece el estilo de unión de los contornos generados en style.

Véase también joinStyle().

void QPainterPathStroker::setMiterLimit(qreal limit)

Establece el límite de inglete de los contornos generados en limit.

El límite de inglete describe a qué distancia de cada junta puede extenderse la junta de inglete. El límite se especifica en unidades de la anchura actual. Así, el límite de inglete en píxeles será miterlimit * width.

Este valor sólo se utiliza si el estilo de unión es Qt::MiterJoin.

Véase también miterLimit().

void QPainterPathStroker::setWidth(qreal width)

Establece la anchura de la ruta del pintor de contornos generada en width.

Los contornos generados se extenderán aproximadamente el 50% de width a cada lado del contorno original del trazado de entrada dado.

Véase también width().

qreal QPainterPathStroker::width() const

Devuelve la anchura de los contornos generados.

Véase también setWidth().

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.