このページでは

PdfScrollablePageView QML Type

一度に1ページをスクロールして表示する完全なPDFビューアコンポーネント。詳細...

Import Statement: import QtQuick.Pdf
Inherits:

Flickable

プロパティ

方法

詳しい説明

PdfScrollablePageViewは、一度に1ページを表示し、スクロールバーでページ内を移動するPDFビューアコンポーネントを提供します。また、テキストを選択してクリップボードにコピーしたり、拡大・縮小したり、内部リンクをクリックして文書の別のセクションにジャンプしたり、ビューを回転させたり、テキストを検索したりすることもサポートしています。pdfviewerのサンプルは、これらの機能をアプリケーションで使用する方法を示しています。

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

PdfPageViewPdfMultiPageViewPdfStyleも参照して ください。

プロパティ・ドキュメンテーション

backEnabled : bool [read-only]

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

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

currentPage : int [read-only]

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

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

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

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

選択されたテキスト。

sourceSize : size

このプロパティは、フルフレームイメージのスケーリングされた幅と高さを保持する。

Image.sourceSizeも参照してください

status : int

このプロパティはcurrent pagerendering status を保持する。

メソッド・ドキュメント

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)

最初のページ全体が、与えられた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()も参照のこと

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