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