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.