Qt PDF

Qt PDF モジュールは、PDF文書をレンダリングするためのクラスと関数を含んでいます。QPdfDocument ク ラ ス は PDF 文書を読み込み、QPdfDocumentRenderOptions ク ラ ス に よ っ て与え ら れたオプシ ョ ンに従っ て そ こ か ら ページ を レ ン ダ リ ます。QPdfPageRenderer クラスは、すべてのレンダリング要求を集めるキューを管理します。QPdfPageNavigator クラスは、PDF文書内のナビゲーションを処理します。QPdfSearchModel クラスは文字列を検索し、検索結果を保持します。QPdfBookmarkModel クラスは、目次があればそれを保持します。QPdfLinkModel はページ上のハイパーリンクに関する情報を保持します。QPdfView ウィジェットは完全なPDFビューアであり、PDFビューアウィジェット例がその使い方を示しています。

Qt Quick アプ リ ケーシ ョ ンについては、 3 種類のフル機能ビ ュ ーア コ ン ポーネ ン ト が提供 さ れてい ます。PdfMultiPageView は、 文書全体のページ を フ リ ッ ク し て表示す る と い う 、 最 も よ く 使われ る ユーザー体験のための最初の選択肢です。PdfScrollablePageView は、 1 ページずつスクロール付きで表示 し 、PdfPageView は、 1 ページずつ全ページを ス ク ロ ールな し で表示 し ます。

フル機能のビューアコンポーネントは、より低レベルのQMLコンポーネントで構成されており、よりカスタマイズされたPDF閲覧アプリケーションを記述する必要がある場合は、個別に使用することができます:PdfDocument PdfPageImagePdfPageNavigatorPdfSelectionPdfSearchModelPdfLinkModelPdfBookmarkModel

テ キ ス ト の選択 ・ 検索 ・ ナビゲーシ ョ ン と いっ た機能がな く て も 、 ページ画像のレ ン ダ リ だけが必要な場合、 こ のモジ ュ ールには、 PDF をSVG に似たスケーラブルな画像フ ォーマ ッ ト と し て扱 うQImageIOHandler プラグインが含まれています。単にImageを使用し、currentFrame プロパティを表示したいページインデックスに設定するだけです。PDFファイルがそれ自身の背景をレンダリングしない場合、画像は透明な背景を持ちます。

モジュールの使用

Qt モジュールを使用するには、モジュール・ライブラリを直接、または他の依存関係を介してリンクする必要があります。CMakeや qmakeなど、いくつかのビルドツールはこのための専用サポートを持っています。

CMake でのビルド

find_package() コマンドを使って、Qt6 パッケージの中から必要なモジュールコンポーネントを探します:

find_package(Qt6 REQUIRED COMPONENTS Pdf)
target_link_libraries(mytarget Qt6::Pdf)

CMakeによるビルドの概要も参照してください。

qmakeでビルドする

モジュールをリンクするには、qmakeプロジェクトファイルに次の行を追加してください:

QT += pdf

APIリファレンス

記事とガイド

  • Qt PDF Platform Notes} {プラットフォームノート} {プラットフォームノート

ライセンスと帰属

Qt PDF は、Qt Company の商用ライセンスで入手できます。また、GNU Lesser General Public License, version 3 またはGNU General Public License, version 2 の下でも利用可能です。このモジュールの詳細についてはQt PDF ライセンスを参照してください。

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