このページでは

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

パブリック型

(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::RGB0すべての色が RGB に変換され、その状態で PDF に保存されます。
QPdfWriter::ColorModel::Grayscale1すべての色がグレースケールに変換されます。下位互換性を確保するため、PDF 出力では、赤、緑、青の量が等しい RGB カラーとして出力されます。
QPdfWriter::ColorModel::CMYK2すべての色が CMYK に変換され、その形式で保存されます。
QPdfWriter::ColorModel::Auto3RGB カラーは RGB として出力され、CMYK カラーは CMYK として出力されます。その他の色指定形式のカラーは RGB に変換されます。これは Qt 6.8 以降のデフォルト設定です。

この列挙型は Qt 6.8 で導入されました。

QColor およびQGradientも参照してください 。

メンバ関数のドキュメント

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