blob: eea7f7c09e3e1fecdc5bfa219c7a268bd8344c7c (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
|
/****************************************************************************
**
** Copyright (C) 2017 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the documentation of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:FDL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU Free Documentation License Usage
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of
** this file. Please review the following information to ensure
** the GNU Free Documentation License version 1.3 requirements
** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
** $QT_END_LICENSE$
**
****************************************************************************/
/*!
\example webenginewidgets/html2pdf
\title WebEngine Widgets Html2Pdf Example
\ingroup webengine-widgetexamples
\brief Converts web pages to PDF documents using Qt WebEngine.
\image html2pdf-example.png
\e {Html2Pdf} demonstrates how to use Qt WebEngine to implement a
command-line application for converting web pages into PDF documents.
\include examples-run.qdocinc
\section1 The Conversion Process
In order to convert a web page into a PDF document we need to:
\list 1
\li Create a \l QWebEnginePage.
\li Tell the \l QWebEnginePage to begin loading the target URL and wait for it to finish.
\li Tell the \l QWebEnginePage to begin converting the loaded page into a PDF file and again wait for it to finish.
\li Once the conversion is finished, exit the program.
\endlist
This process is encapsulated in the \e {Html2PdfConverter} class:
\quotefromfile webenginewidgets/html2pdf/html2pdf.cpp
\skipto #include
\printuntil Html2PdfConverter
\printuntil /^\};/
In the constructor we create the \l QWebEnginePage and connect to its \l
QWebEnginePage::loadFinished and \l QWebEnginePage::pdfPrintingFinished
signals:
\skipto Html2PdfConverter::Html2PdfConverter
\printuntil /^\}/
The \c run() method will trigger the conversion process by asking \l
QWebEnginePage to start loading the target URL. We then enter the main event
loop:
\skipto Html2PdfConverter::run
\printuntil /^\}/
After the loading is finished we begin PDF generation. We ask the \l
QWebEnginePage::printToPdf method to write the output directly to disk:
\skipto Html2PdfConverter::loadFinished
\printuntil /^\}/
Once we receive the signal that the PDF conversion has finished, all that
remains is to report potential errors and exit the program:
\skipto Html2PdfConverter::pdfPrintingFinished
\printuntil /^\}/
\section1 The Main Function
Our \c main function is responsible for setting up a \l QApplication and
parsing command line arguments:
\skipto int main
\printuntil /^\}/
Note that to use Qt WebEngine Widgets we need to create a \l QApplication
and not a \l QCoreApplication, even though this is a command line
application.
*/
|