QPdfWriter Class
QPdfWriter 클래스는 페인트 장치로 사용할 수 있는 PDF를 생성하는 클래스입니다. 더 보기...
| 헤더: | #include <QPdfWriter> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| 상속: | QObject 그리고 QPagedPaintDevice |
- 상속된 멤버를 포함한 모든 멤버 목록
- QPdfWriter는 Painting 클래스의 일부입니다.
공개 유형
(since 6.8) enum class | ColorModel { RGB, Grayscale, CMYK, Auto } |
공개 함수
| QPdfWriter(QIODevice *device) | |
| QPdfWriter(const QString &filename) | |
| virtual | ~QPdfWriter() |
| void | addFileAttachment(const QString &fileName, const QByteArray &data, const QString &mimeType = QString()) |
(since 6.9) QString | author() const |
(since 6.8) QPdfWriter::ColorModel | colorModel() const |
| QString | creator() const |
(since 6.8) QUuid | documentId() const |
| QByteArray | documentXmpMetadata() const |
(since 6.8) QPdfOutputIntent | outputIntent() const |
| QPagedPaintDevice::PdfVersion | pdfVersion() const |
| int | resolution() const |
(since 6.9) void | setAuthor(const QString &author) |
(since 6.8) void | setColorModel(QPdfWriter::ColorModel model) |
| void | setCreator(const QString &creator) |
(since 6.8) void | setDocumentId(QUuid documentId) |
| void | setDocumentXmpMetadata(const QByteArray &xmpMetadata) |
(since 6.8) void | setOutputIntent(const QPdfOutputIntent &intent) |
| void | setPdfVersion(QPagedPaintDevice::PdfVersion version) |
| void | setResolution(int resolution) |
| void | setTitle(const QString &title) |
| QString | title() const |
재구현된 공용 함수
| virtual bool | newPage() override |
재구현된 보호 함수
| virtual QPaintEngine * | paintEngine() const override |
상세 설명
QPdfWriter는 ` QPainter`를 사용하여 일련의 그리기 명령을 바탕으로 PDF를 생성합니다. ` newPage()` 메서드를 사용하여 여러 페이지를 만들 수 있습니다.
멤버 유형 설명
[since 6.8] enum class QPdfWriter::ColorModel
이 열거형은 PDF 엔진이 QPainter 의 펜 또는 브러시로 설정된( QPen 및 QBrush 를 통해) 선색과 채움색을 해석하는 방식을 설명합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QPdfWriter::ColorModel::RGB | 0 | 모든 색상은 RGB로 변환되어 PDF에 그대로 저장됩니다. |
QPdfWriter::ColorModel::Grayscale | 1 | 모든 색상이 그레이스케일로 변환됩니다. 하위 호환성을 위해, PDF 출력에서는 빨강, 녹색, 파랑의 양이 동일한 RGB 색상으로 출력됩니다. |
QPdfWriter::ColorModel::CMYK | 2 | 모든 색상이 CMYK로 변환되어 그대로 저장됩니다. |
QPdfWriter::ColorModel::Auto | 3 | RGB 색상은 RGB로, CMYK 색상은 CMYK로 출력됩니다. 그 외의 색상 사양은 RGB로 변환됩니다. 이는 Qt 6.8부터의 기본 설정입니다. |
이 열거형은 Qt 6.8에서 도입되었습니다.
멤버 함수 문서
[explicit] QPdfWriter::QPdfWriter(QIODevice *device)
device 에 PDF 파일을 작성하는 PDF 작성기를 생성합니다.
[explicit] QPdfWriter::QPdfWriter(const QString &filename)
filename 에 PDF 파일을 작성할 PDF 작성기를 생성합니다.
[virtual noexcept] QPdfWriter::~QPdfWriter()
PDF 작성기를 종료합니다.
void QPdfWriter::addFileAttachment(const QString &fileName, const QByteArray &data, const QString &mimeType = QString())
PDF 파일에 fileName 첨부 파일을 추가하며, 선택적으로 mimeType 도 포함할 수 있습니다. data 에는 PDF 파일에 삽입할 원본 파일 데이터가 포함되어 있습니다.
[since 6.9] QString QPdfWriter::author() const
문서의 작성자를 반환합니다.
이 함수는 Qt 6.9에서 도입되었습니다.
setAuthor()도 참조하십시오 .
[since 6.8] QPdfWriter::ColorModel QPdfWriter::colorModel() const
이 PDF 작성기가 사용하는 색상 모델을 반환합니다. 기본값은 QPdfWriter::ColorModel::Auto 입니다.
이 함수는 Qt 6.8에서 도입되었습니다.
setColorModel()도 참조하십시오 .
QString QPdfWriter::creator() const
문서의 생성자를 반환합니다.
setCreator()도 참조하십시오 .
[since 6.8] QUuid QPdfWriter::documentId() const
문서의 ID를 반환합니다. 기본적으로 ID는 무작위로 생성된 UUID입니다.
이 함수는 Qt 6.8에서 도입되었습니다.
setDocumentId()도 참조하십시오 .
QByteArray QPdfWriter::documentXmpMetadata() const
setDocumentXmpMetadata 호출 시 제공된 대로 문서의 메타데이터를 가져옵니다. 기본 메타데이터는 반환하지 않습니다.
setDocumentXmpMetadata()도 참조하십시오 .
[override virtual] bool QPdfWriter::newPage()
QPagedPaintDevice::newPage()를 재구현합니다.
[since 6.8] QPdfOutputIntent QPdfWriter::outputIntent() const
이 PDF 작성기가 사용하는 출력 인텐트를 반환합니다.
이 함수는 Qt 6.8에서 도입되었습니다.
setOutputIntent()도 참조하십시오 .
[override virtual protected] QPaintEngine *QPdfWriter::paintEngine() const
QPaintDevice::paintEngine() const를 재구현합니다.
QPagedPaintDevice::PdfVersion QPdfWriter::pdfVersion() const
이 작성자에 대한 PDF 버전을 반환합니다. 기본값은 PdfVersion_1_4 입니다.
setPdfVersion()도 참조하십시오 .
int QPdfWriter::resolution() const
PDF의 해상도를 DPI 단위로 반환합니다.
setResolution()도 참조하십시오 .
[since 6.9] void QPdfWriter::setAuthor(const QString &author)
문서의 작성자를 author 로 설정합니다.
이 함수는 Qt 6.9에서 도입되었습니다.
author()도 참조하십시오 .
[since 6.8] void QPdfWriter::setColorModel(QPdfWriter::ColorModel model)
이 PDF 작성기가 사용하는 색상 모델을 ` model`로 설정합니다.
이 함수는 Qt 6.8에서 도입되었습니다.
colorModel()도 참조하십시오 .
void QPdfWriter::setCreator(const QString &creator)
문서의 작성자를 creator 로 설정합니다.
creator()도 참조하십시오 .
[since 6.8] void QPdfWriter::setDocumentId(QUuid documentId)
문서의 ID를 documentId 로 설정합니다.
이 함수는 Qt 6.8에서 도입되었습니다.
documentId()도 참조하십시오 .
void QPdfWriter::setDocumentXmpMetadata(const QByteArray &xmpMetadata)
문서의 메타데이터를 설정합니다. 이 메타데이터는 setTitle / setCreator 메서드의 영향을 받지 않으므로, 일관성을 유지하는 것은 사용자의 몫입니다. xmpMetadata 에는 PDF 파일에 삽입할 XML 형식의 메타데이터가 포함되어 있습니다.
documentXmpMetadata()도 참조하십시오 .
[since 6.8] void QPdfWriter::setOutputIntent(const QPdfOutputIntent &intent)
이 PDF 작성기가 사용하는 출력 인텐트를 ` intent`로 설정합니다.
이 함수는 Qt 6.8에서 도입되었습니다.
outputIntent()도 참조하십시오 .
void QPdfWriter::setPdfVersion(QPagedPaintDevice::PdfVersion version)
이 라이터의 PDF 버전을 ‘ version ’로 설정합니다.
version 가 현재 설정된 값과 동일할 경우 변경 사항이 적용되지 않습니다.
pdfVersion()도 참조하십시오 .
void QPdfWriter::setResolution(int resolution)
PDF의 ‘ resolution ’ 값을 DPI 단위로 설정합니다.
이 설정은 예를 들어 QPainter::viewport() 함수가 반환하는 좌표계에 영향을 미칩니다.
resolution()도 참조하십시오 .
void QPdfWriter::setTitle(const QString &title)
생성 중인 문서의 제목을 ‘ title ’로 설정합니다.
title()도 참조하십시오 .
QString QPdfWriter::title() const
문서의 제목을 반환합니다.
setTitle()도 참조하십시오 .
© 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.
