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 Platform Notes} {プラットフォームノート} Qt PDF API リファレンス

ライセンスと帰属

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