PdfPageNavigator QML Type

PDF文書内の訪問先の履歴。詳細...

• 継承されたメンバを含む全メンバのリスト

プロパティ

• backAvailable : bool
• currentLocation : point
• currentPage : int
• currentZoom : real
• forwardAvailable : bool

信号

• jumped(int page, point location, qreal zoom)

方法

• void back()
• void forward()
• void jump(int page, point location, qreal zoom, bool emitJumped)
• void update(int page, point location, qreal zoom)

詳しい説明

PdfPageNavigator は、ユーザーが PDF 文書のどの目的地を訪れたかを記憶し、前後に移動する機能を提供します。

プロパティの説明

backAvailable : bool [read-only]

履歴にバックディスティネーションがある場合、true 。

currentLocation : point

このプロパティは、表示されているページの現在位置を保持する。

currentPage : int

このプロパティは、現在表示されているページを保持する。現在のページがない場合は、-1 を保持します。

currentZoom : real

このプロパティは、表示されているページの倍率を保持する。

forwardAvailable : bool [read-only]

履歴に転送先がある場合、true 。

シグナルのドキュメント

jumped(int page, point location, qreal zoom)

このシグナルは、指定されたpage インデックス、ページ上のlocation 、そしてzoom レベルへの突然のジャンプが発生したときに発せられる。しかし、単にドキュメントを1ページずつ スクロールしたときには発せられない。つまり、forward （）、back （）、jump （）は常にこのシグナルを発するが、update （）は発しない。

メソッド・ドキュメント

void back()

スタックをポップアップし、currentPage 、currentLocation 、currentZoom プロパティを最新の表示先に更新し、jumped() シグナルを発する。

void forward()

back() が呼ばれる前に表示されていたページ、場所、ズームレベルに戻り、jumped() シグナルを発する。

最後にback()が呼び出されたときから新しい目的地がプッシュされた場合、forward()関数は何もしない。なぜなら、タイムラインに分岐があり、「未来」が失われるからである。

void jump(int page, point location, qreal zoom, bool emitJumped)

page 、location 、zoom からなる、与えられた目的地を、訪問した場所の履歴に追加する。emitJumped がfalse の場合、jumped() シグナルは発せられない。

forwardAvailable がtrue の場合、この関数を呼び出すとタイムラインが分岐し、「未来」が失われるため、forwardAvailable はfalse に変わる。

void update(int page, point location, qreal zoom)

page 、location 、zoom からなる現在の移動先を変更する。

これは、ユーザーが手動でドキュメントを移動している間、定期的に呼び出すことができ、back() が呼び出された後、forward() は、jump() で最後に指定された宛先ではなく、最近表示された宛先にジャンプバックする。

各プロパティが実際に変更されると、currentZoomChanged 、currentPageChanged 、currentLocationChanged シグナルが発行される。jumped シグナルは発せられない。なぜなら、この操作はナビゲーショ ンジャンプではなく、スムーズな移動を表すからである。