PdfMultiPageView QML Type

複数のページをスクロールするための完全なPDFビューアコンポーネント。詳細...

Import Statement: import QtQuick.Pdf
Inherits:

Item

プロパティ

方法

詳細説明

PdfMultiPageViewは、多くの一般的なPDFビューアアプリケーションと同様のユーザー体験を提供するPDFビューアコンポーネントを提供します。これは、ページ画像間の狭いギャップで、ドキュメント全体のページをフリックすることをサポートしています。

PdfMultiPageViewはまた、テキストを選択してクリップボードにコピーしたり、拡大・縮小したり、内部リンクをクリックして文書内の別のセクションにジャンプしたり、ビューを回転させたり、テキストを検索したりすることもサポートしています。PDF Multipage Viewer Exampleは、アプリケーションでこれらの機能を使用する方法を示します。

この実装は、個別に入手可能な小さなビルディングブロックをQMLで組み立てたものです。こ の コ ン ポーネ ン ト の独自バージ ョ ンに変更を加えたい場合には、QtQuick/Pdf/qml のモジ ュ ールディ レ ク ト リ に イ ン ス ト ール さ れてい る QML を コ ピー し て、 必要に応 じ て変更す る こ と がで き ます。

PdfPageViewPdfScrollablePageViewPdfStyleも参照して ください。

プロパティ Documentation

backEnabled : bool [read-only]

このプロパティは、ナビゲーション履歴で前に見たページに戻ることが可能かどうかを示します。

PdfPageNavigator::backAvailable およびback()も参照の こと。


currentPage : int [read-only]

このプロパティは、スクロール可能なビューで表示されているページのゼロベースのページ番号を保持する。現在のページがない場合は、-1を保持する。

こ のプ ロ パテ ィ は読み取 り 専用で、 通常はバ イ ンデ ィ ン グ (またはonCurrentPageChanged ス ク リ プ ト ) で使用 さ れ、 現在のページ番号を表示す る ユーザー イ ン タ フ ェース の一部 (SpinBox など) を更新 し ます。

PdfPageNavigator::currentPageも参照してください


currentPageRenderingStatus : int

このプロパティは、current pagerendering 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

このプロパティは、ユーザが検索するために選択することができる検索文字列を保持します。通常、TextFieldtext プロパティへのバインディングで使用されます。

searchModelも参照して ください。


selectedText : PdfDocument

選択されたテキスト。


メソッド・ドキュメント

void back()

ナビゲーション・スタックに前の場所がない場合は何もしません。

PdfPageNavigator::back()、currentPage 、およびbackEnabledも参照して ください。


void copySelectionToClipboard()

選択されたテキスト(ある場合)をsystem clipboard にコピーします。

selectAll()も参照


void forward()

back() メソッドが呼び出されたときにユーザが表示していたページまでビューをスクロールする。ナビゲーショ ン・スタックに "next" の場所がない場合は何もしない。

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)

最初のページ全体が、与えられたwidthheight を持つビューポートに収まるようにrenderScale を設定します。結果のrenderScalepageRotation に依存します : ページは、アスペクト比が一致するように最初に回転されると、より大きなサイズでビューポートに収まります。


void scaleToWidth(real width, real height)

最初のページの幅が、与えられたwidthheight を持つビューポートに収まるようにrenderScale を設定します。 ページが回転されない場合、その幅がwidth に収まるように拡大縮小されます。ページが±90度回転している場合は、その幅がheight に収まるように拡大縮小されます。


void searchBack()

searchModel's current result を減少させ、前の検索結果にジャンプするようにする。


void searchForward()

searchModel's current result を増やすと、ビューは次の検索結果にジャンプします。


void selectAll()

current page 上のすべてのテキストを選択し、その機能をサポートするシステム上で、システムselection として利用できるようにします。

copySelectionToClipboard()も参照のこと


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