QPdfPageNavigator Class

メンバ関数ドキュメント

[explicit] QPdfPageNavigator::QPdfPageNavigator(QObject *parent)

親オブジェクトparent を持つページナビゲーションスタックを構築する。

[override virtual noexcept] QPdfPageNavigator::~QPdfPageNavigator()

ページナビゲーションスタックを破棄する。

[slot] void QPdfPageNavigator::back()

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

[slot] void QPdfPageNavigator::clear()

履歴を消去し、currentPage 、currentLocation 、currentZoom をデフォルト値に戻す。

[slot] void QPdfPageNavigator::forward()

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

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

[slot] void QPdfPageNavigator::jump(QPdfLink destination)

与えられたdestination を訪問した場所の履歴に追加する。

この場合、PDFビューは、destination.location をビューポートに配置するのとは対照的に、destination.rectangles をビューポートに配置するようにスクロールすることによって、jumped シグナルに応答します。そのため、QPdfSearchModel から検索結果にジャンプするためにこのメソッドを呼び出すのが適切です（矩形が見つかったテキストの領域をカバーしているため）。ハイパーリンク先にジャンプするには、代わりにjump(page, location, zoom)を呼び出します。この場合、QPdfLink オブジェクトのrectangles は、ハイパーリンク先ではなく、ハイパーリンク元の位置をカバーするからです。

[slot] void QPdfPageNavigator::jump(int page, const QPointF &location, qreal zoom = 0)

page 、location 、zoom からなる、指定された目的地を、訪問した場所の履歴に追加する。

引数zoom は倍率を表す（1 はデフォルトの倍率で、1論理ピクセル＝1ポイント）。zoom が与えられないか、0 の場合、currentZoom は既存の値を維持し、currentZoomChanged は発行されない。

ユーザーがリンクをたどっている場合、location はQPdfLink::location() と同じであるべきである。また、移動先の左上隅として指定されているため、常にビューポートの左上隅に見える位置をポイント単位で使用することが一貫性のために最適である。

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

[signal] void QPdfPageNavigator::jumped(QPdfLink current)

このシグナルは、current のページインデックス、ページ上の位置、ズームレベルに対して、突然のジャンプが発生したときに発せられるが、ドキュメントを1ページずつスクロールしただけでは発せられない。つまり、jump （）、forward （）、back （）はこのシグナルを発するが、update （）は発しない。

current.rectangles.length > 0 の場合、それらは特定の目的地領域をカバーする矩形、つまり可視化されるべき検索結果である。そうでない場合、current.location はpage 上の目的地位置である（ハイパーリンクの目的地、または前方/後方ナビゲーション中）。

[slot] void QPdfPageNavigator::update(int page, const QPointF &location, qreal zoom)

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

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

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