Add close() method to QPdfDocument

The close() method will close an open document and emit
the aboutToBeClosed() signal, so that other component, which
keep a pointer to QPdfDocument, can react to it.

Change-Id: I93200eb0b4bf96479fc114b43c9f6f2af4d15ffa
Reviewed-by: Simon Hausmann <simon.hausmann@qt.io>

2 files changed, 31 insertions, 2 deletions

diff --git a/src/pdf/qpdfdocument.cpp b/src/pdf/qpdfdocument.cpp
index 4d6a2e0..6802089 100644
--- a/src/pdf/qpdfdocument.cpp
+++ b/src/pdf/qpdfdocument.cpp
@@ -59,9 +59,9 @@ QPdfDocumentPrivate::QPdfDocumentPrivate()
 
 QPdfDocumentPrivate::~QPdfDocumentPrivate()
 {
-    const QMutexLocker lock(pdfMutex());
+    q->close();
 
-    clear();
+    const QMutexLocker lock(pdfMutex());
 
     if (!--libraryRefCount)
         FPDF_DestroyLibrary();
@@ -249,6 +249,9 @@ QPdfDocument::QPdfDocument(QObject *parent)
     d->q = this;
 }
 
+/*!
+    Destroys the document.
+*/
 QPdfDocument::~QPdfDocument()
 {
 }
@@ -298,6 +301,29 @@ QPdfDocument::Error QPdfDocument::error() const
     return d->lastError;
 }
 
+/*!
+    \fn void QPdfDocument::aboutToBeClosed()
+
+    This signal is emitted whenever the document is closed.
+
+    \sa close()
+*/
+
+/*!
+  Closes the document.
+*/
+void QPdfDocument::close()
+{
+    if (!d->doc)
+        return;
+
+    emit aboutToBeClosed();
+
+    const QMutexLocker lock(pdfMutex());
+
+    d->clear();
+}
+
 int QPdfDocument::pageCount() const
 {
     if (!d->doc)
diff --git a/src/pdf/qpdfdocument.h b/src/pdf/qpdfdocument.h
index 6a46c50..bb3602d 100644
--- a/src/pdf/qpdfdocument.h
+++ b/src/pdf/qpdfdocument.h
@@ -61,6 +61,8 @@ public:
 
     Error error() const;
 
+    void close();
+
     int pageCount() const;
 
     QSizeF pageSize(int page) const;
@@ -71,6 +73,7 @@ Q_SIGNALS:
     void passwordRequired();
     void documentLoadStarted();
     void documentLoadFinished();
+    void aboutToBeClosed();
     void pageCountChanged();
 
 private: