QPaintDevice Class
La clase `QPaintDevice` es la clase base de los objetos sobre los que se puede dibujar con ` QPainter`. Más información...
| Encabezado: | #include <QPaintDevice> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Heredado por: | QImage, QOpenGLPaintDevice, QPagedPaintDevice, QPaintDeviceWindow, QPicture, QPixmap, QSvgGenerator y QWidget |
- Lista de todos los miembros, incluidos los heredados
- QPaintDevice forma parte de las clases de pintura.
Tipos públicos
| enum | PaintDeviceMetric { PdmWidth, PdmHeight, PdmWidthMM, PdmHeightMM, PdmNumColors, …, PdmDevicePixelRatioF_EncodedB } |
Funciones públicas
| virtual | ~QPaintDevice() |
| int | colorCount() const |
| int | depth() const |
| qreal | devicePixelRatio() const |
| qreal | devicePixelRatioF() const |
| int | height() const |
| int | heightMM() const |
| int | logicalDpiX() const |
| int | logicalDpiY() const |
| virtual QPaintEngine * | paintEngine() const = 0 |
| bool | paintingActive() const |
| int | physicalDpiX() const |
| int | physicalDpiY() const |
| int | width() const |
| int | widthMM() const |
Miembros públicos estáticos
(since 6.8) int | encodeMetricF(QPaintDevice::PaintDeviceMetric metric, double value) |
Funciones protegidas
| QPaintDevice() | |
| virtual int | metric(QPaintDevice::PaintDeviceMetric metric) const |
Descripción detallada
Un dispositivo de dibujo es una abstracción de un espacio bidimensional sobre el que se puede dibujar utilizando un ` QPainter`. Su sistema de coordenadas predeterminado tiene su origen situado en la posición superior izquierda. El eje X aumenta hacia la derecha y el eje Y hacia abajo. La unidad es un píxel.
Las capacidades de dibujo de QPaintDevice están implementadas actualmente por las subclases ` QWidget`, ` QImage`, ` QPixmap`, ` QPicture` y ` QPrinter `.
Para implementar la compatibilidad con un nuevo backend, debe derivar de QPaintDevice y reimplementar la función virtual paintEngine() para indicar a QPainter qué motor de dibujo debe utilizarse para dibujar en este dispositivo concreto. Tenga en cuenta que también debe crear el motor de dibujo correspondiente para poder dibujar en el dispositivo, es decir, derivar de QPaintEngine y reimplementar sus funciones virtuales.
Advertencia: Qt requiere que exista un objeto ` QGuiApplication ` antes de que se pueda crear ningún dispositivo de dibujo. Los dispositivos de dibujo acceden a los recursos del sistema de ventanas, y estos recursos no se inicializan hasta que se crea un objeto de aplicación.
La clase `QPaintDevice` proporciona varias funciones que devuelven las distintas métricas del dispositivo: la función ` depth()` devuelve su profundidad de bits (número de planos de bits). La función ` height()` devuelve su altura en unidades del sistema de coordenadas predeterminado (por ejemplo, píxeles para ` QPixmap ` y ` QWidget`), mientras que ` heightMM()` devuelve la altura del dispositivo en milímetros. De forma similar, las funciones width() y widthMM() devuelven la anchura del dispositivo en unidades del sistema de coordenadas predeterminado y en milímetros, respectivamente. Como alternativa, se puede utilizar la función protegida metric() para obtener la información métrica especificando como argumento el sistema de coordenadas deseado PaintDeviceMetric.
Las funciones logicalDpiX() y logicalDpiY() devuelven la resolución horizontal y vertical del dispositivo en puntos por pulgada. Las funciones physicalDpiX() y physicalDpiY() también devuelven la resolución del dispositivo en puntos por pulgada, pero hay que tener en cuenta que, si la resolución lógica y la física difieren, la QPaintEngine correspondiente debe encargarse de la correspondencia. Por último, la función ` colorCount()` devuelve el número de colores diferentes disponibles para el dispositivo de pintura.
Véase también « QPaintEngine» , « QPainter », «Coordinate System» y «Paint System».
Documentación sobre tipos de miembros
enum QPaintDevice::PaintDeviceMetric
Describe las distintas métricas de un dispositivo de pintura.
| Constante | Valor | Descripción |
|---|---|---|
QPaintDevice::PdmWidth | 1 | El ancho del dispositivo de dibujo en las unidades del sistema de coordenadas predeterminado (por ejemplo, píxeles para QPixmap y QWidget). Véase también width(). |
QPaintDevice::PdmHeight | 2 | La altura del dispositivo de dibujo en las unidades del sistema de coordenadas predeterminado (por ejemplo, píxeles para QPixmap y QWidget). Véase también height(). |
QPaintDevice::PdmWidthMM | 3 | La anchura del dispositivo de dibujo en milímetros. Véase también widthMM(). |
QPaintDevice::PdmHeightMM | 4 | La altura del dispositivo de dibujo en milímetros. Véase también heightMM(). |
QPaintDevice::PdmNumColors | 5 | El número de colores diferentes disponibles para el dispositivo de pintura. Véase también colorCount(). |
QPaintDevice::PdmDepth | 6 | La profundidad de bits (número de planos de bits) del dispositivo de pintura. Véase también depth(). |
QPaintDevice::PdmDpiX | 7 | La resolución horizontal del dispositivo en puntos por pulgada. Véase también logicalDpiX(). |
QPaintDevice::PdmDpiY | 8 | La resolución vertical del dispositivo en puntos por pulgada. Véase también logicalDpiY(). |
QPaintDevice::PdmPhysicalDpiX | 9 | La resolución horizontal del dispositivo en puntos por pulgada. Véase también physicalDpiX(). |
QPaintDevice::PdmPhysicalDpiY | 10 | La resolución vertical del dispositivo en puntos por pulgada. Véase también physicalDpiY(). |
QPaintDevice::PdmDevicePixelRatio | 11 | La relación de píxeles del dispositivo. Los valores habituales son 1 para pantallas con dpi normal y 2 para pantallas «Retina» de alto dpi. |
QPaintDevice::PdmDevicePixelRatioScaled | 12 | La relación de píxeles del dispositivo escalada. Es idéntica a `PdmDevicePixelRatio`, salvo que el valor se escala mediante un factor constante para admitir dispositivos de pintura con factores de escala fraccionarios. El factor de escala constante utilizado es `devicePixelRatioFScale()`. Este valor de la enumeración se ha introducido en Qt 5.6. |
QPaintDevice::PdmDevicePixelRatioF_EncodedA (since Qt 6.8) | 13 | Este elemento de la enumeración, junto con el elemento correspondiente « B », se utilizan conjuntamente para la relación de píxeles del dispositivo, como un valor de punto flotante codificado « double ». Una subclase de « QPaintDevice » que admita valores fraccionarios de DPR debería implementar la compatibilidad con estos dos elementos de la enumeración en su reimplementación de la función « metric()». Se espera que el valor devuelto sea el resultado de la función « encodeMetricF()». |
QPaintDevice::PdmDevicePixelRatioF_EncodedB (since Qt 6.8) | 14 | Véase PdmDevicePixelRatioF_EncodedA. |
Véase también metric() y devicePixelRatio().
Documentación de funciones de miembro
[noexcept protected] QPaintDevice::QPaintDevice()
Crea un dispositivo de pintura. Este constructor solo puede invocarse desde subclases de QPaintDevice.
[virtual noexcept] QPaintDevice::~QPaintDevice()
Elimina el dispositivo de dibujo y libera los recursos del sistema de ventanas.
int QPaintDevice::colorCount() const
Devuelve el número de colores diferentes disponibles para el dispositivo de pintura. Si el número de colores disponibles es demasiado elevado como para ser representado por el tipo de datos `int`, se devolverá `INT_MAX` en su lugar.
int QPaintDevice::depth() const
Devuelve la profundidad de bits (número de planos de bits) del dispositivo de pintura.
qreal QPaintDevice::devicePixelRatio() const
Devuelve la relación de píxeles del dispositivo.
Los valores habituales son 1 para pantallas con resolución normal (dpi) y 2 para pantallas «Retina» de alta resolución (dpi).
qreal QPaintDevice::devicePixelRatioF() const
Devuelve la relación de píxeles del dispositivo como un número de punto flotante.
[static, since 6.8] int QPaintDevice::encodeMetricF(QPaintDevice::PaintDeviceMetric metric, double value)
Devuelve un valor codificado según el estándar value para la métrica metric. Las subclases que implementen metric() deben utilizar esta función para codificar
| Constante | Descripción |
|---|---|
as | un valor de retorno entero cuando la métrica de consulta especifica un valor de punto flotante codificado. |
Esta función se introdujo en Qt 6.8.
int QPaintDevice::height() const
Devuelve la altura del dispositivo de dibujo en las unidades predeterminadas del sistema de coordenadas (por ejemplo, píxeles para QPixmap y QWidget).
Véase también heightMM().
int QPaintDevice::heightMM() const
Devuelve la altura del dispositivo de dibujo en milímetros. Debido a las limitaciones de la plataforma, es posible que no se pueda utilizar esta función para determinar el tamaño físico real de un widget en la pantalla.
Véase también height().
int QPaintDevice::logicalDpiX() const
Devuelve la resolución horizontal del dispositivo en puntos por pulgada, que se utiliza para calcular los tamaños de fuente. En X11, suele coincidir con el valor que se obtendría mediante la función ` widthMM()`.
Ten en cuenta que, si el valor de logicalDpiX() no coincide con el de physicalDpiX(), el QPaintEngine correspondiente debe encargarse de la conversión de resolución.
Véanse también logicalDpiY() y physicalDpiX().
int QPaintDevice::logicalDpiY() const
Devuelve la resolución vertical del dispositivo en puntos por pulgada, que se utiliza para calcular los tamaños de fuente. En X11, suele coincidir con el valor que se obtendría mediante la función ` heightMM()`.
Ten en cuenta que, si el valor de `logicalDpiY()` no coincide con el de ` physicalDpiY()`, el ` QPaintEngine ` correspondiente debe encargarse de la conversión de resolución.
Véanse también logicalDpiX() y physicalDpiY().
[virtual protected] int QPaintDevice::metric(QPaintDevice::PaintDeviceMetric metric) const
Devuelve la información métrica del dispositivo de pintura especificado metric.
Véase también PaintDeviceMetric.
[pure virtual] QPaintEngine *QPaintDevice::paintEngine() const
Devuelve un puntero al motor de pintura utilizado para dibujar en el dispositivo.
bool QPaintDevice::paintingActive() const
Devuelve ` true ` si el dispositivo se está pintando en ese momento, es decir, si alguien ha llamado a ` QPainter::begin()` pero aún no ha llamado a ` QPainter::end()` para este dispositivo; en caso contrario, devuelve ` false`.
Véase también QPainter::isActive().
int QPaintDevice::physicalDpiX() const
Devuelve la resolución horizontal del dispositivo en puntos por pulgada. Por ejemplo, al imprimir, esta resolución se refiere a la resolución física de la impresora. Por otro lado, los DPI lógicos se refieren a la resolución utilizada por el motor de dibujo propiamente dicho.
Ten en cuenta que si el valor de physicalDpiX() no coincide con el de logicalDpiX(), el QPaintEngine correspondiente debe gestionar la correspondencia de resoluciones.
Véanse también physicalDpiY() y logicalDpiX().
int QPaintDevice::physicalDpiY() const
Devuelve la resolución horizontal del dispositivo en puntos por pulgada. Por ejemplo, al imprimir, esta resolución se refiere a la resolución física de la impresora. Por otro lado, los DPI lógicos se refieren a la resolución utilizada por el motor de dibujo propiamente dicho.
Ten en cuenta que, si el valor de physicalDpiY() no coincide con el de logicalDpiY(), el QPaintEngine correspondiente debe encargarse de la correspondencia de resoluciones.
Véanse también physicalDpiX() y logicalDpiY().
int QPaintDevice::width() const
Devuelve el ancho del dispositivo de dibujo en las unidades predeterminadas del sistema de coordenadas (por ejemplo, píxeles para QPixmap y QWidget).
Véase también widthMM().
int QPaintDevice::widthMM() const
Devuelve el ancho del dispositivo de dibujo en milímetros. Debido a las limitaciones de la plataforma, es posible que no se pueda utilizar esta función para determinar el tamaño físico real de un widget en la pantalla.
Véase también width().
© 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.