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(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(const QPicture & pic)

Constructs a copy of pic.

This constructor is fast thanks to implicit sharing.

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 = 0)

Loads a picture from 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 save().

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

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 = 0)

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 = 0)

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().

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

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.

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

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