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 |
- Lista de todos los miembros, incluidos los heredados
- QPicture forma parte de las clases compartidas implícitamente.
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) |
Elementos no miembros relacionados
| 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 pictureTen 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 doneLas 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.