PdfMultiPageView QML Type
複数のページをスクロールするための完全なPDFビューアコンポーネント。詳細...
| Import Statement: | import QtQuick.Pdf |
| Inherits: |
プロパティ
- backEnabled : bool
- currentPage : int
- currentPageRenderingStatus : int
- document : PdfDocument
- forwardEnabled : bool
- pageRotation : real
- renderScale : real
- searchModel : PdfSearchModel
- searchString : string
- selectedText : PdfDocument
方法
- void back()
- void copySelectionToClipboard()
- void forward()
- void goToLocation(int page, point location, real zoom)
- void goToPage(int page)
- void resetScale()
- void scaleToPage(real width, real height)
- void scaleToWidth(real width, real height)
- void searchBack()
- void searchForward()
- void selectAll()
詳細説明
PdfMultiPageViewは、多くの一般的なPDFビューアアプリケーションと同様のユーザー体験を提供するPDFビューアコンポーネントを提供します。これは、ページ画像間の狭いギャップで、ドキュメント全体のページをフリックすることをサポートしています。
PdfMultiPageViewはまた、テキストを選択してクリップボードにコピーしたり、拡大・縮小したり、内部リンクをクリックして文書内の別のセクションにジャンプしたり、ビューを回転させたり、テキストを検索したりすることもサポートしています。PDF Multipage Viewer Exampleは、アプリケーションでこれらの機能を使用する方法を示します。
この実装は、個別に入手可能な小さなビルディングブロックをQMLで組み立てたものです。こ の コ ン ポーネ ン ト の独自バージ ョ ンに変更を加えたい場合には、QtQuick/Pdf/qml のモジ ュ ールディ レ ク ト リ に イ ン ス ト ール さ れてい る QML を コ ピー し て、 必要に応 じ て変更す る こ と がで き ます。
PdfPageView 、PdfScrollablePageView 、PdfStyleも参照して ください。
プロパティ・ドキュメンテーション
backEnabled : bool [read-only]
このプロパティは、ナビゲーション履歴で前に見たページに戻ることが可能かどうかを示す。
PdfPageNavigator::backAvailable およびback()も参照のこと 。
currentPage : int [read-only]
このプロパティは、スクロール可能なビューで表示されているページのゼロベースのページ番号を保持する。現在のページがない場合は -1 を保持します。
こ のプ ロ パテ ィ は読み取 り 専用で、 通常はバ イ ンデ ィ ン グ (またはonCurrentPageChanged ス ク リ プ ト ) で使用 さ れ、 現在のページ番号を表示す る ユーザー イ ン タ フ ェース の一部 (SpinBox な ど) を更新 し ます。
PdfPageNavigator::currentPageも参照してください 。
currentPageRenderingStatus : int
このプロパティはcurrent page のrendering status を保持する。
document : PdfDocument [required]
有効なsource URLを持つPdfDocument オブジェクトが必要です:
import QtQuick import QtQuick.Pdf PdfMultiPageView { document: PdfDocument { source: "my.pdf" } }
forwardEnabled : bool [read-only]
このプロパティは、ナビゲーション履歴で次の場所に移動できるかどうかを示す。
PdfPageNavigator::forwardAvailable およびforward()も参照のこと 。
pageRotation : real
このプロパティは、ページの時計回りの回転を保持します。
デフォルト値は0 度です(つまり、PDFファイルに保存されているページの向きに対して回転しません)。
renderScale : real
このプロパティはピクセルとポイントの比率を保持する。デフォルトは1 で、1ポイント(1/72インチ)が1論理ピクセルに相当する。
searchModel : PdfSearchModel
このプロパティは、指定されたsearchString の検索結果リストを含むPdfSearchModel を保持する。
PdfSearchModelも参照してください 。
searchString : string
このプロパティは、ユーザが検索するために選択できる検索文字列を保持する。これは通常、TextField のtext プロパティへのバインディングで使用されます。
searchModelも参照してください 。
selectedText : PdfDocument
選択されたテキスト。
メソッドのドキュメント
void back()
ナビゲーションスタックに前の場所がない場合は何もしない。
PdfPageNavigator::back()、currentPage 、およびbackEnabledも参照のこと 。
void copySelectionToClipboard()
選択したテキスト(あれば)をsystem clipboard にコピーする。
selectAll()も参照 。
void forward()
back() メソッドが呼び出されたときにユーザーが表示していたページまでビューをスクロールします。ナビゲーションスタックに「次」の場所がない場合は何もしません。
PdfPageNavigator::forward() およびcurrentPageも参照のこと 。
void goToLocation(int page, point location, real zoom)
可能であれば、page 上のlocation にビューをスクロールし、zoom レベルを設定します。
PdfPageNavigator::jump() およびcurrentPageも参照のこと 。
void goToPage(int page)
可能であれば、与えられたpage 番号までビューをスクロールする。
PdfPageNavigator::jump() およびcurrentPageも参照のこと 。
void resetScale()
renderScale をデフォルト値の1 に戻す。
void scaleToPage(real width, real height)
最初のページ全体が、与えられたwidth とheight を持つビューポートに収まるようにrenderScale を設定します。結果のrenderScale はpageRotation に依存します: ページは、アスペクト比が一致するように最初に回転されると、より大きなサイズでビューポートに収まります。
void scaleToWidth(real width, real height)
最初のページの幅が、与えられたwidth とheight を持つビューポートに収まるようにrenderScale を設定する。 ページが回転されない場合、その幅がwidth に収まるように拡大縮小される。ページが±90度回転している場合は、幅がheight に収まるように拡大縮小されます。
void searchBack()
searchModel's current result 、前の検索結果にジャンプするようにする。
void searchForward()
ビューが次の検索結果にジャンプするように、searchModel's current result をインクリメントする。
void selectAll()
current page 上のすべてのテキストを選択し、その機能をサポートしているシステム上では、システムselection として利用できるようにする。
copySelectionToClipboard()も参照のこと 。
© 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.