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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
|
/****************************************************************************
**
** Copyright (C) 2016 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the QtGui module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
** 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 Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 3 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL3 included in the
** packaging of this file. Please review the following information to
** ensure the GNU Lesser General Public License version 3 requirements
** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 2.0 or (at your option) the GNU General
** Public license version 3 or any later version approved by the KDE Free
** Qt Foundation. The licenses are as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
** included in the packaging of this file. Please review the following
** information to ensure the GNU General Public License requirements will
** be met: https://www.gnu.org/licenses/gpl-2.0.html and
** https://www.gnu.org/licenses/gpl-3.0.html.
**
** $QT_END_LICENSE$
**
****************************************************************************/
#include "qpagedpaintdevice_p.h"
#include <qpagedpaintdevice.h>
QT_BEGIN_NAMESPACE
QPagedPaintDevicePrivate::~QPagedPaintDevicePrivate()
{
delete rangeCollection;
}
/*!
\class QPagedPaintDevice
\inmodule QtGui
\brief The QPagedPaintDevice class represents a paint device that supports
multiple pages.
\ingroup painting
Paged paint devices are used to generate output for printing or for formats like PDF.
QPdfWriter and QPrinter inherit from it.
*/
/*!
\internal
Constructs a new paged paint device with the derived private class.
*/
QPagedPaintDevice::QPagedPaintDevice(QPagedPaintDevicePrivate *dd)
: d(dd)
{
}
/*!
Destroys the object.
*/
QPagedPaintDevice::~QPagedPaintDevice()
{
delete d;
}
/*!
\internal
Returns the QPagedPaintDevicePrivate.
*/
QPagedPaintDevicePrivate *QPagedPaintDevice::dd()
{
return d;
}
/*!
\fn bool QPagedPaintDevice::newPage()
Starts a new page. Returns \c true on success.
*/
/*!
\enum QPagedPaintDevice::PdfVersion
The PdfVersion enum describes the version of the PDF file that
is produced by QPrinter or QPdfWriter.
\value PdfVersion_1_4 A PDF 1.4 compatible document is produced.
\value PdfVersion_A1b A PDF/A-1b compatible document is produced.
\value PdfVersion_1_6 A PDF 1.6 compatible document is produced.
This value was added in Qt 5.12.
*/
/*!
\since 5.3
Sets the page layout to \a newPageLayout.
You should call this before calling QPainter::begin(), or immediately
before calling newPage() to apply the new page layout to a new page.
You should not call any painting methods between a call to setPageLayout()
and newPage() as the wrong paint metrics may be used.
Returns true if the page layout was successfully set to \a newPageLayout.
\sa pageLayout()
*/
bool QPagedPaintDevice::setPageLayout(const QPageLayout &newPageLayout)
{
return d->setPageLayout(newPageLayout);
}
/*!
\since 5.3
Sets the page size to \a pageSize.
To get the current QPageSize use pageLayout().pageSize().
You should call this before calling QPainter::begin(), or immediately
before calling newPage() to apply the new page size to a new page.
You should not call any painting methods between a call to setPageSize()
and newPage() as the wrong paint metrics may be used.
Returns true if the page size was successfully set to \a pageSize.
\sa pageLayout()
*/
bool QPagedPaintDevice::setPageSize(const QPageSize &pageSize)
{
return d->setPageSize(pageSize);
}
/*!
\since 5.3
Sets the page \a orientation.
The page orientation is used to define the orientation of the
page size when obtaining the page rect.
You should call this before calling QPainter::begin(), or immediately
before calling newPage() to apply the new orientation to a new page.
You should not call any painting methods between a call to setPageOrientation()
and newPage() as the wrong paint metrics may be used.
To get the current QPageLayout::Orientation use pageLayout().orientation().
Returns true if the page orientation was successfully set to \a orientation.
\sa pageLayout()
*/
bool QPagedPaintDevice::setPageOrientation(QPageLayout::Orientation orientation)
{
return d->setPageOrientation(orientation);
}
/*!
\since 5.3
Set the page \a margins defined in the given \a units.
You should call this before calling QPainter::begin(), or immediately
before calling newPage() to apply the new margins to a new page.
You should not call any painting methods between a call to setPageMargins()
and newPage() as the wrong paint metrics may be used.
To get the current page margins use pageLayout().pageMargins().
Returns true if the page margins were successfully set to \a margins.
\sa pageLayout()
*/
bool QPagedPaintDevice::setPageMargins(const QMarginsF &margins, QPageLayout::Unit units)
{
return d->setPageMargins(margins, units);
}
/*!
\since 5.3
Returns the current page layout. Use this method to access the current
QPageSize, QPageLayout::Orientation, QMarginsF, fullRect() and paintRect().
Note that you cannot use the setters on the returned object, you must either
call the individual QPagedPaintDevice setters or use setPageLayout().
\sa setPageLayout(), setPageSize(), setPageOrientation(), setPageMargins()
*/
QPageLayout QPagedPaintDevice::pageLayout() const
{
return d->pageLayout();
}
QT_END_NAMESPACE
|
