QPrintEngine Class
QPrintEngine 클래스는 QPrinter 이 지정된 인쇄 하위 시스템과 상호 작용하는 방식에 대한 인터페이스를 정의합니다. 더 보기...
| Header: | #include <QPrintEngine> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS PrintSupport)target_link_libraries(mytarget PRIVATE Qt6::PrintSupport) |
| qmake: | QT += printsupport |
- 상속된 멤버를 포함한 모든 멤버 목록
- QPrintEngine은 프린터 및 인쇄 API의 일부입니다.
참고: 이 클래스의 모든 함수는 재진입합니다.
공용 유형
| enum | PrintEnginePropertyKey { PPK_CollateCopies, PPK_ColorMode, PPK_Creator, PPK_Duplex, PPK_DocumentName, …, 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(QPrintEngine::PrintEnginePropertyKey key) const = 0 |
| virtual void | setProperty(QPrintEngine::PrintEnginePropertyKey key, const QVariant &value) = 0 |
상세 설명
자체 인쇄 엔진을 만드는 일반적인 경우는 QPaintEngine 와 QPrintEngine 모두에서 파생하는 것입니다. 인쇄 엔진의 다양한 프로퍼티는 property()로 제공되고 setProperty()로 설정됩니다.
QPaintEngine 를참조하세요 .
멤버 유형 문서
enum QPrintEngine::PrintEnginePropertyKey
이 열거형은 인쇄 엔진과 QPrinter 간에 속성을 전달하는 데 사용됩니다. 프로퍼티는 특정 인쇄 엔진에서 지원되거나 지원되지 않을 수 있습니다.
| Constant | 값 | 설명 |
|---|---|---|
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 | Windows에서 DM_PAPER 항목을 지정하는 정수입니다. |
QPrintEngine::PPK_CustomPaperSize | 22 | QPrinter::Point 단위로 사용자 지정 용지 크기를 지정하는 QSizeF. |
QPrintEngine::PPK_PageMargins | 23 | QPrinter::Point 단위의 왼쪽, 위쪽, 오른쪽 및 아래쪽 여백 값을 포함하는 QList<QVariant>입니다. |
QPrintEngine::PPK_CopyCount | 24 | 인쇄할 사본 수를 지정하는 정수입니다. |
QPrintEngine::PPK_SupportsMultipleCopies | 25 | 프린터가 한 작업에서 여러 장 인쇄를 지원하는지 여부를 나타내는 부울 값입니다. |
QPrintEngine::PPK_QPageSize | 27 | QPageSize 객체를 사용하여 페이지 크기를 설정합니다. |
QPrintEngine::PPK_QPageMargins | 28 | QMarginsF 및 QPageLayout::Unit 의 QPair 를 사용하여 페이지 여백을 설정합니다. |
QPrintEngine::PPK_QPageLayout | 29 | QPageLayout 객체를 사용하여 페이지 레이아웃을 설정합니다. |
QPrintEngine::PPK_CustomBase | 0xff00 | 확장 기준. |
멤버 기능 문서
[virtual noexcept] 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()도 참조하세요 .
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
