Класс QPrintEngine
Класс QPrintEngine определяет интерфейс взаимодействия QPrinter с заданной системой печати. Подробнее...
| Заголовок: | #include <QPrintEngine> |
| qmake: | QT += printsupport |
Примечание: Все функции в этом классе являются реентерабельными.
Открытые типы
| перечисление | PrintEnginePropertyKey { PPK_CollateCopies, PPK_ColorMode, PPK_Creator, PPK_Duplex, PPK_DocumentName, …, PPK_CustomBase } |
Открытые функции
| виртуальный | ~QPrintEngine() |
| виртуальный bool | abort() = 0 |
| виртуальный int | metric(QPaintDevice::PaintDeviceMetric id) const = 0 |
| виртуальный bool | newPage() = 0 |
| виртуальный QPrinter::PrinterState | printerState() const = 0 |
| виртуальный QVariant | property(QPrintEngine::PrintEnginePropertyKey key) const = 0 |
| виртуальный void | setProperty(QPrintEngine::PrintEnginePropertyKey key, const QVariant &value) = 0 |
Подробное описание
В общем случае при создании собственного модуля печати необходимо унаследовать от QPaintEngine и QPrintEngine. Различные свойства модуля печати задаются с помощью property() и устанавливаются с помощью setProperty().
См. такжеQPaintEngine.
Документация по типам членов
enum QPrintEngine::PrintEnginePropertyKey
Этот перечисление используется для передачи свойств между движком печати и QPrinter. Свойство может быть или не быть поддерживаемым данным движком печати.
| Постоянная | Значение | Описание |
|---|---|---|
QPrintEngine::PPK_CollateCopies |
0 |
Булево значение, указывающее, должна ли печать быть склеенной. |
QPrintEngine::PPK_ColorMode |
1 |
Относится к QPrinter::ColorMode, либо цветной, либо монохромной. |
QPrintEngine::PPK_Creator |
2 |
Строка, описывающая создателя документа. |
QPrintEngine::PPK_Duplex |
20 |
Булево значение, указывающее, должны ли обе стороны бумаги принтера быть использованы для печати. |
QPrintEngine::PPK_DocumentName |
3 |
Строка, описывающая имя документа в очереди печати. |
QPrintEngine::PPK_FontEmbedding |
19 |
Булево значение, указывающее, должны ли данные шрифтов документа быть встроены в данные, отправляемые на принтер. |
QPrintEngine::PPK_FullPage |
4 |
Булевое значение, описывающее, должен ли принтер печатать на всю страницу. |
QPrintEngine::PPK_NumberOfCopies |
5 |
Устарело. Целое число, определяющее количество копий. Используйте PPK_CopyCount вместо этого. |
QPrintEngine::PPK_Orientation |
6 |
Указывает значение QPrinter::Orientation. |
QPrintEngine::PPK_OutputFileName |
7 |
Имя выходного файла в виде строки. Пустое имя файла указывает, что принтер не должен печатать в файл. |
QPrintEngine::PPK_PageOrder |
8 |
Указывает значение QPrinter::PageOrder. |
QPrintEngine::PPK_PageRect |
9 |
QRect, определяющий прямоугольник страницы. |
QPrintEngine::PPK_PageSize |
10 |
Устарело. Используйте PPK_PaperSize вместо этого. |
QPrintEngine::PPK_PaperRect |
11 |
QRect, определяющий прямоугольник листа. |
QPrintEngine::PPK_PaperSource |
12 |
Указывает значение QPrinter::PaperSource. |
QPrintEngine::PPK_PaperSources |
21 |
Указывает несколько значений QPrinter::PaperSource. |
QPrintEngine::PPK_PaperName |
26 |
Строка, определяющая имя листа. |
QPrintEngine::PPK_PaperSize |
PPK_PageSize |
Указывает значение QPrinter::PaperSize. |
QPrintEngine::PPK_PrinterName |
13 |
Строка, определяющая имя принтера. |
QPrintEngine::PPK_PrinterProgram |
14 |
Строка, определяющая имя программы принтера, используемой для печати. |
QPrintEngine::PPK_Resolution |
15 |
Целое число, описывающее точки на дюйм для данного принтера. |
QPrintEngine::PPK_SelectionOption |
16 |
|
QPrintEngine::PPK_SupportedResolutions |
17 |
Список целых QVariants, описывающий набор поддерживаемых разрешений принтера. |
QPrintEngine::PPK_WindowsPageSize |
18 |
Целое число, определяющее запись DM_PAPER в Windows. |
QPrintEngine::PPK_CustomPaperSize |
22 |
QSizeF, определяющий пользовательский размер листа в единицах QPrinter::Point. |
QPrintEngine::PPK_PageMargins |
23 |
QList<QVariant>, содержащий значения полей слева, сверху, справа и снизу в единицах QPrinter::Point. |
QPrintEngine::PPK_CopyCount |
24 |
Целое число, определяющее количество копий для печати. |
QPrintEngine::PPK_SupportsMultipleCopies |
25 |
Булево значение, указывающее, поддерживает ли принтер печать нескольких копий в одном задании. |
QPrintEngine::PPK_QPageSize |
27 |
Установить размер страницы с помощью объекта QPageSize. |
QPrintEngine::PPK_QPageMargins |
28 |
Установить поля страницы с помощью пары QPair из QMarginsF и QPageLayout::Unit. |
QPrintEngine::PPK_QPageLayout |
29 |
Установить макет страницы с помощью объекта QPageLayout. |
QPrintEngine::PPK_CustomBase |
0xff00 |
Основа для расширения. |
Документация по функциям-членам
[virtual] QPrintEngine::~QPrintEngine()
Удаляет движок печати.
[pure virtual] bool QPrintEngine::abort()
Инструктирует движок печати прервать процесс печати. Возвращает true, если операция выполнена успешно; в противном случае возвращает false.
[pure virtual] int QPrintEngine::metric(QPaintDevice::PaintDeviceMetric id) const
Возвращает метрику для данного id.
[pure virtual] bool QPrintEngine::newPage()
Инструктирует движок печати начать новую страницу. Возвращает true если принтер смог создать новую страницу; в противном случае возвращает false.
[pure virtual] QPrinter::PrinterState QPrintEngine::printerState() const
Возвращает текущее состояние принтера, используемого принтерным движком.
[pure virtual] QVariant QPrintEngine::property(QPrintEngine::PrintEnginePropertyKey key) const
Возвращает свойство принтерного движка, заданное параметром key.
См. также setProperty().
[pure virtual] void QPrintEngine::setProperty(QPrintEngine::PrintEnginePropertyKey key, const QVariant &value)
Устанавливает свойство принтерного движка, заданное параметром key, в указанное значение value.
См. также property().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qprintengine.html
