Класс QPagedPaintDevice
Класс QPagedPaintDevice представляет устройство рисования, поддерживающее несколько страниц. Подробнее...
| Заголовок: | #include <QPagedPaintDevice> |
| qmake: | QT += gui |
| Наследуется от: | QPaintDevice |
| Наследуется: |
Общедоступные типы
| класс | Margins |
| перечисление | PageSize { A0, A1, A2, A3, ..., LastPageSize } |
Общедоступные функции
| QPagedPaintDevice() | |
| ~QPagedPaintDevice() | |
| Margins | margins() const |
| виртуальный bool | newPage() = 0 |
| QPageLayout | pageLayout() const |
| PageSize | pageSize() const |
| QSizeF | pageSizeMM() const |
| виртуальный void | setMargins(const 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(PageSize size) |
| виртуальный void | setPageSizeMM(const QSizeF &size) |
- 14 общедоступных функций, унаследованных от QPaintDevice
Дополнительные унаследованные члены
- 1 защищённая функция, унаследованная от QPaintDevice
Подробное описание
Класс QPagedPaintDevice представляет устройство рисования, поддерживающее несколько страниц.
Устройства рисования со страницами используются для генерации вывода для печати или для форматов, таких как 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, если необходимо.
Документация по функциям-членам
QPagedPaintDevice::QPagedPaintDevice()
Создаёт новый устройство рисования для страниц.
QPagedPaintDevice::~QPagedPaintDevice()
Удаляет объект.
Margins QPagedPaintDevice::margins() const
Возвращает текущие поля устройства рисования. По умолчанию — 0.
Поля задаются в миллиметрах.
См. также setMargins().
bool QPagedPaintDevice::newPage()
Начинает новую страницу. Возвращает true при успехе.
QPageLayout QPagedPaintDevice::pageLayout() const
Возвращает текущий макет страницы. Используйте этот метод для доступа к текущему QPageSize, QPageLayout::Orientation, QMarginsF, fullRect() и paintRect().
Обратите внимание, что вы не можете использовать методы установки на возвращённый объект. Вы должны либо вызвать отдельные методы установки QPagedPaintDevice, или использовать setPageLayout().
Эта функция была добавлена в Qt 5.3.
См. также setPageLayout(), setPageSize(), setPageOrientation() и setPageMargins().
PageSize QPagedPaintDevice::pageSize() const
Возвращает текущий используемый размер страницы.
См. также setPageSize().
QSizeF QPagedPaintDevice::pageSizeMM() const
Возвращает размер страницы в миллиметрах.
См. также setPageSizeMM().
void QPagedPaintDevice::setMargins(const 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(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.9/qpagedpaintdevice.html