Класс QPagedPaintDevice

Класс QPagedPaintDevice представляет устройство рисования, поддерживающее несколько страниц. Подробнее...

• Список всех членов, включая унаследованные

Открытые типы

Открытые функции

• 14 открытых функций, унаследованных от QPaintDevice

Дополнительные унаследованные члены

• 1 защищённая функция, унаследованная от QPaintDevice

Подробное описание

Класс QPagedPaintDevice представляет устройство рисования, поддерживающее несколько страниц.

Устройства рисования с поддержкой страниц используются для вывода на печать или для форматов, таких как PDF. QPdfWriter и QPrinter наследуются от него.

Документация по типам членов

перечисление QPagedPaintDevice::PageSize

Это перечисление содержит доступные размеры страниц, определённые в стандарте Postscript PPD. Эти значения дублируются в QPageSize и QPrinter.

Определённые размеры:

По историческим причинам 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().