QPdfView Class

PDFビューアウィジェット。詳細...

Header: #include <QPdfView>
Inherits: QAbstractScrollArea

パブリックタイプ

enum class PageMode { SinglePage, MultiPage }
enum class ZoomMode { Custom, FitToWidth, FitInView }

プロパティ

パブリック機能

QPdfView(QWidget *parent)
virtual ~QPdfView()
int currentSearchResultIndex() const
QPdfDocument *document() const
QMargins documentMargins() const
QPdfView::PageMode pageMode() const
QPdfPageNavigator *pageNavigator() const
int pageSpacing() const
QPdfSearchModel *searchModel() const
void setDocument(QPdfDocument *document)
void setDocumentMargins(QMargins margins)
void setPageSpacing(int spacing)
void setSearchModel(QPdfSearchModel *searchModel)
qreal zoomFactor() const
QPdfView::ZoomMode zoomMode() const

パブリックスロット

void setCurrentSearchResultIndex(int currentResult)
void setPageMode(QPdfView::PageMode mode)
void setZoomFactor(qreal factor)
void setZoomMode(QPdfView::ZoomMode mode)

シグナル

void currentSearchResultIndexChanged(int currentResult)
void documentChanged(QPdfDocument *document)
void documentMarginsChanged(QMargins documentMargins)
void pageModeChanged(QPdfView::PageMode pageMode)
void pageSpacingChanged(int pageSpacing)
void searchModelChanged(QPdfSearchModel *searchModel)
void zoomFactorChanged(qreal zoomFactor)
void zoomModeChanged(QPdfView::ZoomMode zoomMode)

詳細説明

QPdfViewは、多くの一般的なPDFビューアアプリケーションと同様のユーザーエクスペリエンスを提供するPDFビューアウィジェットで、2つのmodesMultiPage モードでは、ドキュメント全体のページを、ページ画像間の狭いギャップでフリックすることをサポートします。SinglePage モードでは、一度に1ページを表示します。

メンバータイプ ドキュメント

enum class QPdfView::PageMode

この列挙型は、PDFビューアの全体的な動作を記述します:

定数説明
QPdfView::PageMode::SinglePage0一度に1ページを表示する。
QPdfView::PageMode::MultiPage1文書内の全ページのスクロールを許可する。

enum class QPdfView::ZoomMode

この列挙型は、PDFビューアの拡大動作を記述する:

定数説明
QPdfView::ZoomMode::Custom0zoomFactor のみ使用。
QPdfView::ZoomMode::FitToWidth1ページの幅がビューに収まるように、自動的に拡大率を選択する。
QPdfView::ZoomMode::FitInView2ページ全体がビューに収まるように、自動的にズームファクターを選択します。

プロパティ ドキュメント

[since 6.6] currentSearchResultIndex : int

このプロパティが正の数に設定され、searchModel が設定されている場合、QPdfView は、QPdfSearchModel が提供する検索結果の周囲に、指定されたインデックスで枠を描画する。例えば、QPdfSearchModelQListView のモデルとして使用されている場合、QListView::selectionModel() からQItemSelectionModel::currentChanged() を、この関数を呼び出す関数に接続することで、このプロパティを更新し続けることができます。

デフォルトでは、検索結果がフレーム化されないように、-1

このプロパティは Qt 6.6 で導入されました。

アクセス関数:

int currentSearchResultIndex() const
void setCurrentSearchResultIndex(int currentResult)

Notifier シグナル:

void currentSearchResultIndexChanged(int currentResult)

document : QPdfDocument*

このプロパティは、閲覧する文書を保持する。

アクセス関数:

QPdfDocument *document() const
void setDocument(QPdfDocument *document)

通知シグナル

void documentChanged(QPdfDocument *document)

documentMargins : QMargins

このプロパティは、ページビューの周囲の余白を保持する。

アクセス関数

QMargins documentMargins() const
void setDocumentMargins(QMargins margins)

通知シグナル

void documentMarginsChanged(QMargins documentMargins)

pageMode : PageMode

こ のプ ロ パテ ィ は、 文書内のページ を 1 つずつ表示す る か、 あ ら ゆ る ページ を表示す る か を保持 し ます。デフォルトはSinglePage です。

アクセス関数:

QPdfView::PageMode pageMode() const
void setPageMode(QPdfView::PageMode mode)

ノーティファイアシグナル:

void pageModeChanged(QPdfView::PageMode pageMode)

pageSpacing : int

このプロパティは、MultiPage mode におけるページ間のパディングのサイズを保持します。

アクセス関数

int pageSpacing() const
void setPageSpacing(int spacing)

通知シグナル:

void pageSpacingChanged(int pageSpacing)

[since 6.6] searchModel : QPdfSearchModel*

このプロパティが設定されている場合、QPdfView は、QPdfSearchModel::resultsOnPage()によって提供された検索結果の上にハイライトの矩形を描く。デフォルトでは、nullptr

このプロパティは Qt 6.6 で導入されました。

アクセス関数です:

QPdfSearchModel *searchModel() const
void setSearchModel(QPdfSearchModel *searchModel)

通知シグナル:

void searchModelChanged(QPdfSearchModel *searchModel)

zoomFactor : qreal

このプロパティはピクセルとポイントの比率を保持する。デフォルトは1 で、1ポイント(1/72インチ)が1論理ピクセルに相当する。

アクセス関数:

qreal zoomFactor() const
void setZoomFactor(qreal factor)

通知シグナル:

void zoomFactorChanged(qreal zoomFactor)

zoomMode : ZoomMode

このプロパティは、ページのカスタムサイズを使用するか、ビューに合わせてズームするかを示します。デフォルトはCustomZoom です。

アクセス関数:

QPdfView::ZoomMode zoomMode() const
void setZoomMode(QPdfView::ZoomMode mode)

通知シグナル:

void zoomModeChanged(QPdfView::ZoomMode zoomMode)

メンバ関数ドキュメント

[explicit] QPdfView::QPdfView(QWidget *parent)

親ウィジェットparent で PDF ビューアを構築します。

[virtual noexcept] QPdfView::~QPdfView()

PDFビューアを破壊する。

このアクセサは、戻る/進むナビゲーションを処理するナビゲーションスタックを返します。

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