QPdfView#

A PDF viewer widget. More

Inheritance diagram of PySide6.QtPdfWidgets.QPdfView

Synopsis#

Functions#

Slots#

Signals#

Detailed Description#

QPdfView is a PDF viewer widget that offers a user experience similar to many common PDF viewer applications, with two modes . In the MultiPage mode, it supports flicking through the pages in the entire document, with narrow gaps between the page images. In the SinglePage mode, it shows one page at a time.

class PySide6.QtPdfWidgets.QPdfView#

PySide6.QtPdfWidgets.QPdfView(parent)

Parameters

parentPySide6.QtWidgets.QWidget

Constructs a PDF viewer with parent widget parent.

PySide6.QtPdfWidgets.QPdfView.PageMode#

This enum describes the overall behavior of the PDF viewer:

Constant

Description

QPdfView.PageMode.SinglePage

Show one page at a time.

QPdfView.PageMode.MultiPage

Allow scrolling through all pages in the document.

PySide6.QtPdfWidgets.QPdfView.ZoomMode#

This enum describes the magnification behavior of the PDF viewer:

Constant

Description

QPdfView.ZoomMode.Custom

Use zoomFactor only.

QPdfView.ZoomMode.FitToWidth

Automatically choose a zoom factor so that the width of the page fits in the view.

QPdfView.ZoomMode.FitInView

Automatically choose a zoom factor so that the entire page fits in the view.

PySide6.QtPdfWidgets.QPdfView.document()#
Return type

PySide6.QtPdf.QPdfDocument

This property holds the document to be viewed.

PySide6.QtPdfWidgets.QPdfView.documentChanged(document)#
Parameters

documentPySide6.QtPdf.QPdfDocument

PySide6.QtPdfWidgets.QPdfView.documentMargins()#
Return type

PySide6.QtCore.QMargins

This property holds the margins around the page view.

PySide6.QtPdfWidgets.QPdfView.documentMarginsChanged(documentMargins)#
Parameters

documentMarginsPySide6.QtCore.QMargins

PySide6.QtPdfWidgets.QPdfView.pageMode()#
Return type

PageMode

This property holds whether to show one page at a time, or all pages in the document. The default is SinglePage.

PySide6.QtPdfWidgets.QPdfView.pageModeChanged(pageMode)#
Parameters

pageModePageMode

PySide6.QtPdfWidgets.QPdfView.pageNavigator()#
Return type

PySide6.QtPdf.QPdfPageNavigator

This accessor returns the navigation stack that will handle back/forward navigation.

PySide6.QtPdfWidgets.QPdfView.pageSpacing()#
Return type

int

This property holds the size of the padding between pages in the MultiPage mode .

PySide6.QtPdfWidgets.QPdfView.pageSpacingChanged(pageSpacing)#
Parameters

pageSpacing – int

PySide6.QtPdfWidgets.QPdfView.setDocument(document)#
Parameters

documentPySide6.QtPdf.QPdfDocument

This property holds the document to be viewed.

PySide6.QtPdfWidgets.QPdfView.setDocumentMargins(margins)#
Parameters

marginsPySide6.QtCore.QMargins

This property holds the margins around the page view.

PySide6.QtPdfWidgets.QPdfView.setPageMode(mode)#
Parameters

modePageMode

This property holds whether to show one page at a time, or all pages in the document. The default is SinglePage.

PySide6.QtPdfWidgets.QPdfView.setPageSpacing(spacing)#
Parameters

spacing – int

This property holds the size of the padding between pages in the MultiPage mode .

PySide6.QtPdfWidgets.QPdfView.setZoomFactor(factor)#
Parameters

factor – float

This property holds the ratio of pixels to points. The default is 1, meaning one point (1/72 of an inch) equals 1 logical pixel.

PySide6.QtPdfWidgets.QPdfView.setZoomMode(mode)#
Parameters

modeZoomMode

This property indicates whether to use a custom size for the page(s), or zoom them to fit to the view. The default is CustomZoom.

PySide6.QtPdfWidgets.QPdfView.zoomFactor()#
Return type

float

This property holds the ratio of pixels to points. The default is 1, meaning one point (1/72 of an inch) equals 1 logical pixel.

PySide6.QtPdfWidgets.QPdfView.zoomFactorChanged(zoomFactor)#
Parameters

zoomFactor – float

PySide6.QtPdfWidgets.QPdfView.zoomMode()#
Return type

ZoomMode

This property indicates whether to use a custom size for the page(s), or zoom them to fit to the view. The default is CustomZoom.

PySide6.QtPdfWidgets.QPdfView.zoomModeChanged(zoomMode)#
Parameters

zoomModeZoomMode