QPicture Class

         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

         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

Member Function Documentation

QPicture::QPicture(const QPicture &pic)

Constructs a copy of pic.

This constructor is fast thanks to implicit sharing.

QPicture::QPicture(int formatVersion = -1)

Constructs an empty picture.

The formatVersion parameter may be used to create a QPicture that can be read by applications that are compiled with earlier versions of Qt.

Note that the default formatVersion is -1 which signifies the current release, i.e. for Qt 4.0 a formatVersion of 7 is the same as the default formatVersion of -1.

Reading pictures generated by earlier versions of Qt is not supported in Qt 4.0.

QPicture &QPicture::operator=(QPicture &&other)

Move-assigns other to this QPicture instance.

This function was introduced in Qt 5.2.

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

Assigns picture p to this picture and returns a reference to this picture.

[virtual] QPicture::~QPicture()

Destroys the picture.

QRect QPicture::boundingRect() const

Returns the picture's bounding rectangle or an invalid rectangle if the picture contains no data.

See also setBoundingRect().

const char *QPicture::data() const

Returns a pointer to the picture data. The pointer is only valid until the next non-const function is called on this picture. The returned pointer is 0 if the picture contains no data.

See also setData(), size(), and isNull().

bool QPicture::isNull() const

Returns true if the picture contains no data; otherwise returns false.

bool QPicture::load(const QString &fileName, const char *format = nullptr)

Loads a picture from the file specified by fileName and returns true if successful; otherwise invalidates the picture and returns false.

Please note that the format parameter has been deprecated and will have no effect.

See also save().

bool QPicture::load(QIODevice *dev, const char *format = nullptr)

This is an overloaded function.

dev is the device to use for loading.

bool QPicture::play(QPainter *painter)

Replays the picture using painter, and returns true if successful; otherwise returns false.

This function does exactly the same as QPainter::drawPicture() with (x, y) = (0, 0).

bool QPicture::save(const QString &fileName, const char *format = nullptr)

Saves a picture to the file specified by fileName and returns true if successful; otherwise returns false.

Please note that the format parameter has been deprecated and will have no effect.

See also load().

bool QPicture::save(QIODevice *dev, const char *format = nullptr)

This is an overloaded function.

dev is the device to use for saving.

void QPicture::setBoundingRect(const QRect &r)

Sets the picture's bounding rectangle to r. The automatically calculated value is overridden.

See also boundingRect().

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

Sets the picture data directly from data and size. This function copies the input data.

See also data() and size().

uint QPicture::size() const

Returns the size of the picture data.

See also data().

void QPicture::swap(QPicture &other)

Swaps picture other with this picture. This operation is very fast and never fails.

This function was introduced in Qt 4.8.