En esta página

QPicture Class

La clase QPicture es un dispositivo de dibujo que graba y reproduce comandos de « QPainter ». Más información...

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

Funciones públicas

QPicture(int formatVersion = -1)
QPicture(const QPicture &pic)
virtual ~QPicture()
QRect boundingRect() const
const char *data() const
bool isNull() const
bool load(const QString &fileName)
bool load(QIODevice *dev)
bool play(QPainter *painter)
bool save(const QString &fileName)
bool save(QIODevice *dev)
void setBoundingRect(const QRect &r)
virtual void setData(const char *data, uint size)
uint size() const
void swap(QPicture &other)
QPicture &operator=(QPicture &&other)
QPicture &operator=(const QPicture &p)
QDataStream &operator<<(QDataStream &s, const QPicture &r)
QDataStream &operator>>(QDataStream &s, QPicture &r)

Descripción detallada

Una imagen serializa los comandos del pintor a un dispositivo de E/S en un formato independiente de la plataforma. A veces se denominan «metarchivos».

Las imágenes de Qt utilizan un formato binario propio. A diferencia de los formatos de imagen nativos (metarchivos) de muchos sistemas de ventanas, las imágenes de Qt no tienen limitaciones en cuanto a su contenido. Todo lo que se puede dibujar en un widget o mapa de píxeles (por ejemplo, fuentes, mapas de píxeles, regiones, gráficos transformados, etc.) también se puede almacenar en una imagen.

QPicture es independiente de la resolución, es decir, un QPicture puede mostrarse en diferentes dispositivos (por ejemplo, SVG, PDF, PS, impresora y pantalla) con el mismo aspecto. Esto es necesario, por ejemplo, para la vista previa de impresión WYSIWYG. QPicture funciona con los ppp predeterminados del sistema y escala el elemento de dibujo para adaptarse a las diferencias de resolución en función del sistema de ventanas.

Ejemplo de cómo grabar una imagen:

QPicture picture;
QPainter painter;
painter.begin(&picture);           // paint in picture
painter.drawEllipse(10,20, 80,70); // draw an ellipse
painter.end();                     // painting done
picture.save("drawing.pic");       // save picture

Ten en cuenta que la lista de comandos del pincel se restablece cada vez que se llama a la función ` QPainter::begin()`.

Ejemplo de cómo reproducir una imagen:

QPicture picture;
picture.load("drawing.pic");           // load picture
QPainter painter;
painter.begin(&myImage);               // paint in myImage
painter.drawPicture(0, 0, picture);    // draw the picture at (0,0)
painter.end();                         // painting done

Las imágenes también se pueden dibujar utilizando play(). Se dispone de algunos datos básicos sobre una imagen, por ejemplo, size(), isNull() y boundingRect().

Nota: QPicture utiliza QDataStream para la serialización. Se aplican las same reservations relativas a la lectura de datos no fiables.

Véase también QMovie.

Documentación de las funciones de miembro

[explicit] QPicture::QPicture(int formatVersion = -1)

Crea una imagen vacía.

El parámetro ` formatVersion ` puede utilizarse para crear un `QPicture` que puedan leer las aplicaciones compiladas con versiones anteriores de Qt.

Ten en cuenta que el valor predeterminado de formatVersion es -1, lo que indica la versión actual; es decir, para Qt 4.0, un valor de formatVersion igual a 7 equivale al valor predeterminado de -1.

En Qt 4.0 no se admite la lectura de imágenes generadas por versiones anteriores de Qt.

QPicture::QPicture(const QPicture &pic)

Crea una copia de ` pic`.

Este constructor es rápido gracias al uso compartido implícito.

[virtual noexcept] QPicture::~QPicture()

Echa a perder la imagen.

QRect QPicture::boundingRect() const

Devuelve el rectángulo delimitador de la imagen o un rectángulo no válido si la imagen no contiene datos.

Véase también ` setBoundingRect()`.

const char *QPicture::data() const

Devuelve un puntero a los datos de la imagen. El puntero solo es válido hasta que se llame a la siguiente función no const sobre esta imagen. El puntero devuelto es 0 si la imagen no contiene datos.

Véase también setData(), size() y isNull().

bool QPicture::isNull() const

Devuelve « true » si la imagen no contiene datos; en caso contrario, devuelve «false».

bool QPicture::load(const QString &fileName)

Carga una imagen desde el archivo especificado mediante ` fileName ` y devuelve `true` si la operación se realiza correctamente; en caso contrario, invalida la imagen y devuelve ` false`.

Véase también save().

bool QPicture::load(QIODevice *dev)

dev es el dispositivo que hay que utilizar para la carga.

Esta es una función sobrecargada.

bool QPicture::play(QPainter *painter)

Reproduce la imagen utilizando ` painter` y devuelve ` true ` si se realiza correctamente; en caso contrario, devuelve ` false`.

Esta función hace exactamente lo mismo que « QPainter::drawPicture()» con (x, y) = (0, 0).

Nota: Esta función no conservael estado del pintor.

bool QPicture::save(const QString &fileName)

Guarda una imagen en el archivo especificado por ` fileName ` y devuelve `true` si se realiza correctamente; en caso contrario, devuelve ` false`.

Véase también load().

bool QPicture::save(QIODevice *dev)

dev es el dispositivo que hay que utilizar para guardar.

Se trata de una función sobrecargada.

void QPicture::setBoundingRect(const QRect &r)

Establece el rectángulo delimitador de la imagen en r. Se anula el valor calculado automáticamente.

Véase también ` boundingRect()`.

[virtual] void QPicture::setData(const char *data, uint size)

Establece los datos de la imagen directamente desde data y size. Esta función copia los datos de entrada.

Véanse también data() y size().

uint QPicture::size() const

Devuelve el tamaño de los datos de la imagen.

Véase también data().

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

Intercambia esta imagen con other. Esta operación es muy rápida y nunca falla.

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

Asigna « other » a esta instancia de « QPicture ». .

QPicture &QPicture::operator=(const QPicture &p)

Asigna la imagen p a esta imagen y devuelve una referencia a esta imagen.

Elementos relacionados que no son miembros

QDataStream &operator<<(QDataStream &s, const QPicture &r)

Escribe la imagen r en el flujo s y devuelve una referencia al flujo.

QDataStream &operator>>(QDataStream &s, QPicture &r)

Lee una imagen del flujo s y la guarda en la imagen r, y devuelve una referencia al flujo.

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