En esta página

QPaintEngineState Class

La clase `QPaintEngineState` proporciona información sobre el estado actual del motor de dibujo activo. Más...

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

Nota: Todas las funciones de esta clase son reentrantes.

Funciones públicas

QBrush backgroundBrush() const
Qt::BGMode backgroundMode() const
QBrush brush() const
bool brushNeedsResolving() const
QPointF brushOrigin() const
Qt::ClipOperation clipOperation() const
QPainterPath clipPath() const
QRegion clipRegion() const
QPainter::CompositionMode compositionMode() const
QFont font() const
bool isClipEnabled() const
qreal opacity() const
QPainter *painter() const
QPen pen() const
bool penNeedsResolving() const
QPainter::RenderHints renderHints() const
QPaintEngine::DirtyFlags state() const
QTransform transform() const

Descripción detallada

QPaintEngineState registra qué propiedades han cambiado desde la última actualización del motor de pintura, así como su valor actual.

Las propiedades que han cambiado se pueden recuperar en cualquier momento mediante la función ` state()`. Esta función devuelve una instancia del tipo ` QPaintEngine::DirtyFlags `, que almacena una combinación OR de los valores ` QPaintEngine::DirtyFlag `. La enumeración ` QPaintEngine::DirtyFlag ` define si una propiedad ha cambiado desde la última actualización o no.

Si una propiedad está marcada con un indicador de modificación, su valor actual se puede recuperar utilizando la función get correspondiente:

La clase `QPaintEngineState` también proporciona la función ` painter()`, que devuelve un puntero al pintor que está actualizando actualmente el motor de pintura.

Una instancia de esta clase, que representa el estado actual del motor de pintura activo, se pasa como argumento a la función ` QPaintEngine::updateState()`. La única situación en la que tendrás que utilizar esta clase directamente es al implementar tu propio motor de pintura.

Véase también QPaintEngine.

Documentación de las funciones miembro

QBrush QPaintEngineState::backgroundBrush() const

Devuelve el pincel de fondo en el estado actual del motor de pintura.

Esta variable solo debe utilizarse cuando la función state() devuelve una combinación que incluya el indicador QPaintEngine::DirtyBackground.

Véase también state() y QPaintEngine::updateState().

Qt::BGMode QPaintEngineState::backgroundMode() const

Devuelve el modo de fondo en el estado actual del motor de dibujo.

Esta variable solo debe utilizarse cuando la función state() devuelve una combinación que incluya el indicador QPaintEngine::DirtyBackgroundMode.

Véanse también las funciones ` state()` y ` QPaintEngine::updateState()`.

QBrush QPaintEngineState::brush() const

Devuelve el pincel en el estado actual del motor de pintura.

Esta variable solo debe utilizarse cuando la función state() devuelve una combinación que incluya el indicador QPaintEngine::DirtyBrush.

Véanse también state() y QPaintEngine::updateState().

bool QPaintEngineState::brushNeedsResolving() const

Devuelve si se ha especificado que las coordenadas del relleno están delimitadas por la operación de renderizado actual y deben resolverse (en relación con la primitiva que se está renderizando actualmente).

QPointF QPaintEngineState::brushOrigin() const

Devuelve el origen del pincel en el estado actual del motor de pintura.

Esta variable solo debe utilizarse cuando la función state() devuelve una combinación que incluya el indicador QPaintEngine::DirtyBrushOrigin.

Véanse también state() y QPaintEngine::updateState().

Qt::ClipOperation QPaintEngineState::clipOperation() const

Devuelve la operación de recorte en el estado actual del motor de pintura.

Esta variable solo debe utilizarse cuando la función state() devuelve una combinación que incluya el indicador QPaintEngine::DirtyClipPath o el indicador QPaintEngine::DirtyClipRegion.

Véanse también state() y QPaintEngine::updateState().

QPainterPath QPaintEngineState::clipPath() const

Devuelve la ruta de recorte en el estado actual del motor de pintura.

Esta variable solo debe utilizarse cuando la función state() devuelve una combinación que incluya el indicador QPaintEngine::DirtyClipPath.

Véanse también state() y QPaintEngine::updateState().

QRegion QPaintEngineState::clipRegion() const

Devuelve la región de recorte en el estado actual del motor de pintura.

Esta variable solo debe utilizarse cuando la función state() devuelve una combinación que incluya el indicador QPaintEngine::DirtyClipRegion.

Véanse también state() y QPaintEngine::updateState().

QPainter::CompositionMode QPaintEngineState::compositionMode() const

Devuelve el modo de composición en el estado actual del motor de pintura.

Esta variable solo debe utilizarse cuando la función state() devuelve una combinación que incluya el indicador QPaintEngine::DirtyCompositionMode.

Véanse también state() y QPaintEngine::updateState().

QFont QPaintEngineState::font() const

Devuelve la fuente en el estado actual del motor de dibujo.

Esta variable solo debe utilizarse cuando la función state() devuelve una combinación que incluya el indicador QPaintEngine::DirtyFont.

Véase también state() y QPaintEngine::updateState().

bool QPaintEngineState::isClipEnabled() const

Devuelve si el recorte está activado o no en el estado actual del motor de dibujo.

Esta variable solo debe utilizarse cuando la función state() devuelve una combinación que incluya el indicador QPaintEngine::DirtyClipEnabled.

Véanse también state() y QPaintEngine::updateState().

qreal QPaintEngineState::opacity() const

Devuelve la opacidad en el estado actual del motor de pintura.

QPainter *QPaintEngineState::painter() const

Devuelve un puntero al «painter» que está actualizando en ese momento el motor de pintura.

QPen QPaintEngineState::pen() const

Devuelve el lápiz en el estado actual del motor de pintura.

Esta variable solo debe utilizarse cuando la función state() devuelve una combinación que incluya el indicador QPaintEngine::DirtyPen.

Véanse también state() y QPaintEngine::updateState().

bool QPaintEngineState::penNeedsResolving() const

Devuelve si se ha especificado que la coordenada del trazo está limitada por la operación de representación actual y debe resolverse (en relación con la primitiva representada actualmente).

QPainter::RenderHints QPaintEngineState::renderHints() const

Devuelve las indicaciones de renderizado en el estado actual del motor de pintura.

Esta variable solo debe utilizarse cuando la función state() devuelve una combinación que incluya el indicador QPaintEngine::DirtyHints.

Véanse también state() y QPaintEngine::updateState().

QPaintEngine::DirtyFlags QPaintEngineState::state() const

Devuelve una combinación de indicadores que identifican el conjunto de propiedades que deben actualizarse al actualizar el estado del motor de dibujo (es decir, durante una llamada a la función QPaintEngine::updateState()).

Véase también QPaintEngine::updateState().

QTransform QPaintEngineState::transform() const

Devuelve la matriz en el estado actual del motor de dibujo.

Esta variable solo debe utilizarse cuando la función ` state()` devuelve una combinación que incluya el indicador ` QPaintEngine::DirtyTransform `.

Véanse también state() y QPaintEngine::updateState().

© 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.