Класс QPrintEngine
Класс QPrintEngine определяет интерфейс взаимодействия QPrinter с заданной системой печати. Подробнее...
| Заголовок: | #include <QPrintEngine> |
| CMake: | find_package(Qt6 COMPONENTS PrintSupport REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| 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 |
Указывает значение QPageLayout::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-6.0/qprintengine.html
