QPdfWriter Class

QPdfWriter 클래스는 페인트 장치로 사용할 수 있는 PDF를 생성하는 클래스입니다. 더 보기...

Header: #include <QPdfWriter>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
상속합니다: QObjectQPagedPaintDevice

공용 형

(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.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.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 의 펜 또는 브러시( QPenQBrush 를 통해)로 설정된 획 및 채우기 색상을 해석하는 방식을 설명합니다.

Constant설명
QPdfWriter::ColorModel::RGB0모든 색상이 RGB로 변환되어 PDF에 그대로 저장됩니다.
QPdfWriter::ColorModel::Grayscale1모든 색상은 그레이스케일로 변환됩니다. 이전 버전과의 호환성을 위해 빨간색, 녹색, 파란색의 양이 동일한 RGB 색상으로 PDF 출력에 출력됩니다.
QPdfWriter::ColorModel::CMYK2모든 색상은 CMYK로 변환되어 그대로 저장됩니다.
QPdfWriter::ColorModel::Auto3RGB 색상은 RGB로, CMYK 색상은 CMYK로 출력됩니다. 다른 색상 사양의 색상은 RGB로 변환됩니다. 이것은 Qt 6.8 이후의 기본값입니다.

이 열거형은 Qt 6.8에서 도입되었습니다.

QColorQGradient참조하십시오 .

멤버 함수 문서

[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.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.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()도 참조하세요 .

© 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.