Класс QPrintEngine
Класс QPrintEngine определяет интерфейс взаимодействия QPrinter с заданной подсистемой печати. Подробнее...
| Заголовок: | #include <QPrintEngine> |
| qmake: | QT += printsupport |
Примечание: Все функции в этом классе являются реентерабельными.
Типы
| Перечисление | PrintEnginePropertyKey { PPK_CollateCopies, PPK_ColorMode, PPK_Creator, PPK_Duplex, ..., PPK_CustomBase } |
Публичные функции
| 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(PrintEnginePropertyKey key) const = 0 |
| virtual void | setProperty(PrintEnginePropertyKey key, const QVariant &value) = 0 |
Подробное описание
Класс QPrintEngine определяет интерфейс взаимодействия QPrinter с заданной подсистемой печати.
В типичном случае создания собственного принтерного движка необходимо унаследовать как от QPaintEngine, так и от QPrintEngine. Различные свойства принтерного движка задаются с помощью property() и устанавливаются с помощью setProperty().
См. также QPaintEngine.
Документация по типам элементов
enum QPrintEngine::PrintEnginePropertyKey
Этот перечисление используется для передачи свойств между принтерным движком и QPrinter. Свойство может быть или не быть поддерживаемым данным принтерным движком.
| Константа | Значение | Описание |
|---|---|---|
QPrintEngine::PPK_CollateCopies |
0 |
Булевое значение, указывающее, должна ли печать быть упорядоченной (collated) или нет. |
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/archives/qt-5.6/qprintengine.html
