QPrintEngine Class
QPrintEngine 클래스는 QPrinter 가 특정 인쇄 하위 시스템과 상호 작용하는 방식에 대한 인터페이스를 정의합니다. 더 보기...
| 헤더: | #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 간에 속성을 교환하는 데 사용됩니다. 특정 프린트 엔진에 따라 속성이 지원될 수도 있고 지원되지 않을 수도 있습니다.
| 상수 | 값 | 설명 |
|---|---|---|
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 | 이 프린터의 인치당 도트 수(dpi)를 나타내는 정수입니다. |
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 의 std::pair를 사용하여 페이지 여백을 설정합니다. |
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()도 참조하십시오 .
© 2026 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.
