Qt PDF

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

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

フル機能のビューアコンポーネントは、より低レベルのQMLコンポーネントで構成されており、よりカスタマイズされたPDF閲覧アプリケーションを書く必要がある場合には、それらを個別に使用することができます：PdfDocument PdfPageImage 、PdfPageNavigator 、PdfSelection 、PdfSearchModel 、PdfLinkModel 、PdfBookmarkModel 。

テ キ ス ト の選択 ・ 検索 ・ ナビゲーシ ョ ン と いっ た機能を持たず、 ページ画像のレ ン ダ リ ン グのみを行 う 必要があ る 場合には、 こ のモジ ュ ールには、 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

例

• Qt PDF の例

APIリファレンス

• Qt PDF C++ Classes
• Qt Quick PDF QML Types

記事とガイド

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

ライセンスと帰属

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