このページでは

PdfPageView QML Type

一度に1ページを表示するPDFビューアコンポーネント。詳細...

Import Statement: import QtQuick.Pdf
Inherits:

Rectangle

プロパティ

方法

詳しい説明

PdfPageViewは、スクロールせずに一度に1ページ全体を表示するPDFビューアコンポーネントを提供します。テキストを選択してクリップボードにコピーしたり、拡大・縮小したり、内部リンクをクリックして文書の別のセクションにジャンプしたり、ビューを回転させたり、テキストを検索したりすることができます。

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

PdfScrollablePageViewPdfMultiPageViewPdfStyleも参照して ください。

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

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

PdfPageView {
    document: PdfDocument { source: "my.pdf" }
}

forwardEnabled : bool [read-only]

このプロパティは、ナビゲーション履歴で次の場所に移動できるかどうかを示す。

PdfPageNavigator::forwardAvailable およびforward()も参照のこと

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 を保持する。

zoomEnabled : bool

このプロパティは、ユーザーがピンチジェスチャーまたは Control + マウスホイールを使用してズームできるかどうかを保持します。デフォルトはtrue です。

ユーザーがページをズームすると、PdfPageView のサイズが変更されます。

メソッド・ドキュメント

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 を設定します。結果のrenderScale は、ページの回転に依存します: ページは、最初に一致するアスペクト比を持つように回転された場合、より大きなサイズでビューポートに収まります。

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.