Класс QPagedPaintDevice
Класс QPagedPaintDevice представляет устройство рисования, поддерживающее несколько страниц. Подробнее...
| Заголовок: | #include <QPagedPaintDevice> |
| qmake: | QT += gui |
| Наследуется от: | QPaintDevice |
| Наследующие классы: |
Публичные типы
| Перечисление | PageSize { A0, A1, A2, A3, A4, …, LastPageSize } |
| Перечисление | PdfVersion { PdfVersion_1_4, PdfVersion_A1b, PdfVersion_1_6 } |
Публичные функции
| виртуальный | ~QPagedPaintDevice() |
| QPagedPaintDevice::Margins | margins() const |
| виртуальный bool | newPage() = 0 |
| QPageLayout | pageLayout() const |
| QPagedPaintDevice::PageSize | pageSize() const |
| QSizeF | pageSizeMM() const |
| виртуальный void | setMargins(const QPagedPaintDevice::Margins &margins) |
| bool | setPageLayout(const QPageLayout &newPageLayout) |
| bool | setPageMargins(const QMarginsF &margins) |
| bool | setPageMargins(const QMarginsF &margins, QPageLayout::Unit units) |
| bool | setPageOrientation(QPageLayout::Orientation orientation) |
| bool | setPageSize(const QPageSize &pageSize) |
| виртуальный void | setPageSize(QPagedPaintDevice::PageSize size) |
| виртуальный void | setPageSizeMM(const QSizeF &size) |
Подробное описание
Устройства рисования с поддержкой страниц используются для генерации вывода для печати или для форматов, таких как PDF. QPdfWriter и QPrinter наследуются от него.
Документация по типам членов
Перечисление QPagedPaintDevice::PageSize
Это перечисление содержит доступные размеры страниц, определенные в стандарте Postscript PPD. Эти значения дублируются в QPageSize и QPrinter.
Определенные размеры:
| Константа | Значение | Описание |
|---|---|---|
QPagedPaintDevice::A0 |
5 |
841 x 1189 мм |
QPagedPaintDevice::A1 |
6 |
594 x 841 мм |
QPagedPaintDevice::A2 |
7 |
420 x 594 мм |
QPagedPaintDevice::A3 |
8 |
297 x 420 мм |
QPagedPaintDevice::A4 |
0 |
210 x 297 мм, 8.26 x 11.69 дюймов |
QPagedPaintDevice::A5 |
9 |
148 x 210 мм |
QPagedPaintDevice::A6 |
10 |
105 x 148 мм |
QPagedPaintDevice::A7 |
11 |
74 x 105 мм |
QPagedPaintDevice::A8 |
12 |
52 x 74 мм |
QPagedPaintDevice::A9 |
13 |
37 x 52 мм |
QPagedPaintDevice::B0 |
14 |
1000 x 1414 мм |
QPagedPaintDevice::B1 |
15 |
707 x 1000 мм |
QPagedPaintDevice::B2 |
17 |
500 x 707 мм |
QPagedPaintDevice::B3 |
18 |
353 x 500 мм |
QPagedPaintDevice::B4 |
19 |
250 x 353 мм |
QPagedPaintDevice::B5 |
1 |
176 x 250 мм, 6.93 x 9.84 дюймов |
QPagedPaintDevice::B6 |
20 |
125 x 176 мм |
QPagedPaintDevice::B7 |
21 |
88 x 125 мм |
QPagedPaintDevice::B8 |
22 |
62 x 88 мм |
QPagedPaintDevice::B9 |
23 |
33 x 62 мм |
QPagedPaintDevice::B10 |
16 |
31 x 44 мм |
QPagedPaintDevice::C5E |
24 |
163 x 229 мм |
QPagedPaintDevice::Comm10E |
25 |
105 x 241 мм, обычный конверт 10 США |
QPagedPaintDevice::DLE |
26 |
110 x 220 мм |
QPagedPaintDevice::Executive |
4 |
7.5 x 10 дюймов, 190.5 x 254 мм |
QPagedPaintDevice::Folio |
27 |
210 x 330 мм |
QPagedPaintDevice::Ledger |
28 |
431.8 x 279.4 мм |
QPagedPaintDevice::Legal |
3 |
8.5 x 14 дюймов, 215.9 x 355.6 мм |
QPagedPaintDevice::Letter |
2 |
8.5 x 11 дюймов, 215.9 x 279.4 мм |
QPagedPaintDevice::Tabloid |
29 |
279.4 x 431.8 мм |
QPagedPaintDevice::Custom |
30 |
Неизвестно или размер, заданный пользователем. |
QPagedPaintDevice::A10 |
31 |
|
QPagedPaintDevice::A3Extra |
32 |
|
QPagedPaintDevice::A4Extra |
33 |
|
QPagedPaintDevice::A4Plus |
34 |
|
QPagedPaintDevice::A4Small |
35 |
|
QPagedPaintDevice::A5Extra |
36 |
|
QPagedPaintDevice::B5Extra |
37 |
|
QPagedPaintDevice::JisB0 |
38 |
|
QPagedPaintDevice::JisB1 |
39 |
|
QPagedPaintDevice::JisB2 |
40 |
|
QPagedPaintDevice::JisB3 |
41 |
|
QPagedPaintDevice::JisB4 |
42 |
|
QPagedPaintDevice::JisB5 |
43 |
|
QPagedPaintDevice::JisB6 |
44 |
, |
QPagedPaintDevice::JisB7 |
45 |
|
QPagedPaintDevice::JisB8 |
46 |
|
QPagedPaintDevice::JisB9 |
47 |
|
QPagedPaintDevice::JisB10 |
48 |
|
QPagedPaintDevice::AnsiA |
Letter |
= Буква |
QPagedPaintDevice::AnsiB |
Ledger |
= Журнал |
QPagedPaintDevice::AnsiC |
49 |
|
QPagedPaintDevice::AnsiD |
50 |
|
QPagedPaintDevice::AnsiE |
51 |
|
QPagedPaintDevice::LegalExtra |
52 |
|
QPagedPaintDevice::LetterExtra |
53 |
|
QPagedPaintDevice::LetterPlus |
54 |
|
QPagedPaintDevice::LetterSmall |
55 |
|
QPagedPaintDevice::TabloidExtra |
56 |
|
QPagedPaintDevice::ArchA |
57 |
|
QPagedPaintDevice::ArchB |
58 |
|
QPagedPaintDevice::ArchC |
59 |
|
QPagedPaintDevice::ArchD |
60 |
|
QPagedPaintDevice::ArchE |
61 |
|
QPagedPaintDevice::Imperial7x9 |
62 |
|
QPagedPaintDevice::Imperial8x10 |
63 |
|
QPagedPaintDevice::Imperial9x11 |
64 |
|
QPagedPaintDevice::Imperial9x12 |
65 |
|
QPagedPaintDevice::Imperial10x11 |
66 |
|
QPagedPaintDevice::Imperial10x13 |
67 |
|
QPagedPaintDevice::Imperial10x14 |
68 |
|
QPagedPaintDevice::Imperial12x11 |
69 |
|
QPagedPaintDevice::Imperial15x11 |
70 |
|
QPagedPaintDevice::ExecutiveStandard |
71 |
|
QPagedPaintDevice::Note |
72 |
QPagedPaintDevice::Quarto |
73 |
|
QPagedPaintDevice::Statement |
74 |
|
QPagedPaintDevice::SuperA |
75 |
|
QPagedPaintDevice::SuperB |
76 |
|
QPagedPaintDevice::Postcard |
77 |
|
QPagedPaintDevice::DoublePostcard |
78 |
|
QPagedPaintDevice::Prc16K |
79 |
|
QPagedPaintDevice::Prc32K |
80 |
|
QPagedPaintDevice::Prc32KBig |
81 |
|
QPagedPaintDevice::FanFoldUS |
82 |
|
QPagedPaintDevice::FanFoldGerman |
83 |
|
QPagedPaintDevice::FanFoldGermanLegal |
84 |
|
QPagedPaintDevice::EnvelopeB4 |
85 |
|
QPagedPaintDevice::EnvelopeB5 |
86 |
|
QPagedPaintDevice::EnvelopeB6 |
87 |
|
QPagedPaintDevice::EnvelopeC0 |
88 |
|
QPagedPaintDevice::EnvelopeC1 |
89 |
|
QPagedPaintDevice::EnvelopeC2 |
90 |
|
QPagedPaintDevice::EnvelopeC3 |
91 |
|
QPagedPaintDevice::EnvelopeC4 |
92 |
|
QPagedPaintDevice::EnvelopeC5 |
C5E |
= C5E |
QPagedPaintDevice::EnvelopeC6 |
93 |
|
QPagedPaintDevice::EnvelopeC65 |
94 |
|
QPagedPaintDevice::EnvelopeC7 |
95 |
|
QPagedPaintDevice::EnvelopeDL |
DLE |
= DLE |
QPagedPaintDevice::Envelope9 |
96 |
|
QPagedPaintDevice::Envelope10 |
Comm10E |
= Comm10E |
QPagedPaintDevice::Envelope11 |
97 |
|
QPagedPaintDevice::Envelope12 |
98 |
|
QPagedPaintDevice::Envelope14 |
99 |
|
QPagedPaintDevice::EnvelopeMonarch |
100 |
|
QPagedPaintDevice::EnvelopePersonal |
101 |
|
QPagedPaintDevice::EnvelopeChou3 |
102 |
|
QPagedPaintDevice::EnvelopeChou4 |
103 |
|
QPagedPaintDevice::EnvelopeInvite |
104 |
|
QPagedPaintDevice::EnvelopeItalian |
105 |
|
QPagedPaintDevice::EnvelopeKaku2 |
106 |
|
QPagedPaintDevice::EnvelopeKaku3 |
107 |
|
QPagedPaintDevice::EnvelopePrc1 |
108 |
|
QPagedPaintDevice::EnvelopePrc2 |
109 |
|
QPagedPaintDevice::EnvelopePrc3 |
110 |
|
QPagedPaintDevice::EnvelopePrc4 |
111 |
|
QPagedPaintDevice::EnvelopePrc5 |
112 |
|
QPagedPaintDevice::EnvelopePrc6 |
113 |
|
QPagedPaintDevice::EnvelopePrc7 |
114 |
|
QPagedPaintDevice::EnvelopePrc8 |
115 |
|
QPagedPaintDevice::EnvelopePrc9 |
116 |
|
QPagedPaintDevice::EnvelopePrc10 |
117 |
|
QPagedPaintDevice::EnvelopeYou4 |
118 |
|
QPagedPaintDevice::LastPageSize |
EnvelopeYou4 |
= EnvelopeYou4 |
По историческим причинам QPageSize::Executive не совпадает со стандартным размером Postscript и Windows Executive, используйте QPageSize::ExecutiveStandard вместо этого.
Стандартный размер Postscript QPageSize::Folio отличается от размера Windows DMPAPER_FOLIO, используйте стандартный размер Postscript QPageSize::FanFoldGermanLegal, если необходимо.
enum QPagedPaintDevice::PdfVersion
Перечисление PdfVersion описывает версию файла PDF, который создаётся QPrinter или QPdfWriter.
| Постоянная | Значение | Описание |
|---|---|---|
QPagedPaintDevice::PdfVersion_1_4 |
0 |
Создаётся документ, совместимый с PDF 1.4. |
QPagedPaintDevice::PdfVersion_A1b |
1 |
Создаётся документ, совместимый с PDF/A-1b. |
QPagedPaintDevice::PdfVersion_1_6 |
2 |
Создаётся документ, совместимый с PDF 1.6. Это значение было добавлено в Qt 5.12. |
Документация по функциям-членам
[virtual] QPagedPaintDevice::~QPagedPaintDevice()
Уничтожает объект.
QPagedPaintDevice::Margins QPagedPaintDevice::margins() const
Возвращает текущие поля устройства отрисовки. По умолчанию 0.
Поля задаются в миллиметрах.
См. также setMargins().
[pure virtual] bool QPagedPaintDevice::newPage()
Начинает новую страницу. Возвращает true при успехе.
QPageLayout QPagedPaintDevice::pageLayout() const
Возвращает текущую компоновку страницы. Используйте этот метод для доступа к текущему QPageSize, QPageLayout::Orientation, QMarginsF, fullRect() и paintRect().
Обратите внимание, что вы не можете использовать методы установки на возвращённом объекте; необходимо либо вызвать отдельные методы установки для QPagedPaintDevice, либо использовать setPageLayout().
Эта функция была добавлена в Qt 5.3.
См. также setPageLayout(), setPageSize(), setPageOrientation() и setPageMargins().
QPagedPaintDevice::PageSize QPagedPaintDevice::pageSize() const
Возвращает текущий размер страницы.
См. также setPageSize().
QSizeF QPagedPaintDevice::pageSizeMM() const
Возвращает размер страницы в миллиметрах.
См. также setPageSizeMM().
[virtual] void QPagedPaintDevice::setMargins(const QPagedPaintDevice::Margins &margins)
Устанавливает поля в margins.
Поля задаются в миллиметрах.
Поля — это просто подсказка для метода рисования. Они не влияют на систему координат или обрезку.
См. также margins().
bool QPagedPaintDevice::setPageLayout(const QPageLayout &newPageLayout)
Устанавливает макет страницы на newPageLayout.
Вы должны вызвать эту функцию перед вызовом QPainter::begin() или сразу перед вызовом newPage() для применения нового макета страницы к новой странице. Не следует вызывать какие-либо методы рисования между вызовом setPageLayout() и newPage(), так как могут быть использованы неправильные метрики рисования.
Возвращает true, если макет страницы был успешно установлен на newPageLayout.
Эта функция была добавлена в Qt 5.3.
См. также pageLayout().
bool QPagedPaintDevice::setPageMargins(const QMarginsF &margins)
Устанавливает поля страницы margins в текущих единицах измерения макета страницы.
Вы должны вызвать эту функцию перед вызовом QPainter::begin() или сразу перед вызовом newPage() для применения новых полей к новой странице. Не следует вызывать какие-либо методы рисования между вызовом setPageMargins() и newPage(), так как могут быть использованы неправильные метрики рисования.
Чтобы получить текущие поля страницы, используйте pageLayout().pageMargins().
Возвращает true, если поля страницы были успешно установлены на margins.
Эта функция была добавлена в Qt 5.3.
См. также pageLayout().
bool QPagedPaintDevice::setPageMargins(const QMarginsF &margins, QPageLayout::Unit units)
Устанавливает поля страницы margins, заданные в указанных units.
Вы должны вызвать эту функцию перед вызовом QPainter::begin() или сразу перед вызовом newPage() для применения новых полей к новой странице. Не следует вызывать какие-либо методы рисования между вызовом setPageMargins() и newPage(), так как могут быть использованы неправильные метрики рисования.
Чтобы получить текущие поля страницы, используйте pageLayout().pageMargins().
Возвращает true, если поля страницы были успешно установлены на margins.
Эта функция была добавлена в Qt 5.3.
См. также pageLayout().
bool QPagedPaintDevice::setPageOrientation(QPageLayout::Orientation orientation)
Устанавливает ориентацию страницы orientation.
Ориентация страницы используется для определения ориентации размера страницы при получении прямоугольника страницы.
Вы должны вызвать эту функцию перед вызовом QPainter::begin() или сразу перед вызовом newPage() для применения новой ориентации к новой странице. Не следует вызывать какие-либо методы рисования между вызовом setPageOrientation() и newPage(), так как могут быть использованы неправильные метрики рисования.
Чтобы получить текущую ориентацию QPageLayout::Orientation, используйте pageLayout().pageOrientation().
Возвращает true, если ориентация страницы была успешно установлена на orientation.
Эта функция была добавлена в Qt 5.3.
См. также pageLayout().
bool QPagedPaintDevice::setPageSize(const QPageSize &pageSize)
Устанавливает размер страницы на pageSize.
Чтобы получить текущий QPageSize, используйте pageLayout().pageSize().
Вы должны вызвать эту функцию перед вызовом QPainter::begin() или сразу перед вызовом newPage() для применения нового размера страницы к новой странице. Не следует вызывать какие-либо методы рисования между вызовом setPageSize() и newPage(), так как могут быть использованы неправильные метрики рисования.
Возвращает true, если размер страницы был успешно установлен на pageSize.
Эта функция была добавлена в Qt 5.3.
См. также pageSize() и pageLayout().
void QPagedPaintDevice::setPageSize(QPagedPaintDevice::PageSize size)
Устанавливает размер страницы на size.
См. также setPageSizeMM().
void QPagedPaintDevice::setPageSizeMM(const QSizeF &size)
Устанавливает размер страницы на size. size задаётся в миллиметрах.
Если размер соответствует стандартному QPagedPaintDevice::PageSize, то будет использован этот размер страницы, в противном случае будет установлено QPagedPaintDevice::Custom.
См. также pageSizeMM().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qpagedpaintdevice.html
