Класс QPrintEngine
Класс QPrintEngine определяет интерфейс взаимодействия QPrinter с заданной подсистемой печати. Подробнее...
| Заголовок: | #include <QPrintEngine> |
| CMake: | find_package(Qt6 COMPONENTS PrintSupport REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake: | QT += printsupport |
Примечание: Все функции в этом классе являются повторно входящими.
Типы public
| Перечисление | PrintEnginePropertyKey { PPK_CollateCopies, PPK_ColorMode, PPK_Creator, PPK_Duplex, PPK_DocumentName, …, PPK_CustomBase } |
Функции public
| virtual | ~QPrintEngine() |
| virtual bool | abort() = 0 |
| virtual int | metric(QPaintDevice::PaintDeviceMetric id) const = 0 |
| virtual bool | newPage() = 0 |
| virtual QPrinter::PrinterState | printerState() const = 0 |
| virtual QVariant | property(QPrintEngine::PrintEnginePropertyKey key) const = 0 |
| virtual 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 |
Список целочисленных QVariant, описывающих набор поддерживаемых разрешений принтера. |
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 |
Установите поля страницы с помощью пары 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.1/qprintengine.html
