QMovie: Add lastError and lastErrorString getters

QMovie has an error signal, but it is not possible for users to
"catch" all errors, for instance, if they occur at construction time, and
furthermore, it may not be convenient to add interception of the signal
just to find out what the error was.

[ChangeLog][QtGui][QMovie] Added lastError and lastErrorString accessors,
as a convenience over connecting to the error() signal.

Change-Id: I9c6ef70694c67986ecd30b5dc1b321c4dfa5c315
Reviewed-by: Gunnar Sletta <gunnar@crimson.no>
This commit is contained in:
Robin Burchell 2017-03-15 17:52:01 +01:00
parent 01a4d09ef6
commit 6bf9972621
2 changed files with 29 additions and 0 deletions

View File

@ -161,6 +161,8 @@
This signal is emitted by QMovie when the error \a error occurred during
playback. QMovie will stop the movie, and enter QMovie::NotRunning state.
\sa lastError(), lastErrorString()
*/
/*! \fn void QMovie::finished()
@ -792,6 +794,8 @@ QImage QMovie::currentImage() const
/*!
Returns \c true if the movie is valid (e.g., the image data is readable and
the image format is supported); otherwise returns \c false.
For information about why the movie is not valid, see lastError().
*/
bool QMovie::isValid() const
{
@ -799,6 +803,29 @@ bool QMovie::isValid() const
return d->isValid();
}
/*!
Returns the most recent error that occurred while attempting to read image data.
\sa lastErrorString()
*/
QImageReader::ImageReaderError QMovie::lastError() const
{
Q_D(const QMovie);
return d->reader->error();
}
/*!
Returns a human-readable representation of the most recent error that occurred
while attempting to read image data.
\sa lastError()
*/
QString QMovie::lastErrorString() const
{
Q_D(const QMovie);
return d->reader->errorString();
}
/*!
Returns the number of frames in the movie.

View File

@ -106,6 +106,8 @@ public:
QPixmap currentPixmap() const;
bool isValid() const;
QImageReader::ImageReaderError lastError() const;
QString lastErrorString() const;
bool jumpToFrame(int frameNumber);
int loopCount() const;