QPicture Class Reference

 #include <QPicture>

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

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

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