QPdfView

A PDF viewer widget. More…

Synopsis

Properties

• document

• documentMargins

• pageMode

• pageSpacing

• zoomFactor

• zoomMode

Functions

• def document ()

• def documentMargins ()

• def pageMode ()

• def pageNavigator ()

• def pageSpacing ()

• def setDocument (document)

• def setDocumentMargins (margins)

• def setPageSpacing (spacing)

• def zoomFactor ()

• def zoomMode ()

Slots

• def setPageMode (mode)

• def setZoomFactor (factor)

• def setZoomMode (mode)

Signals

• def documentChanged (document)

• def documentMarginsChanged (documentMargins)

• def pageModeChanged (pageMode)

• def pageSpacingChanged (pageSpacing)

• def zoomFactorChanged (zoomFactor)

• def zoomModeChanged (zoomMode)

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

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:

parent – PySide6.QtWidgets.QWidget

Constructs a PDF viewer with parent widget parent.

Note

Properties can be used directly when from __feature__ import true_property is used or via accessor functions otherwise.

property PᅟySide6.QtPdfWidgets.QPdfView.document: PySide6.QtPdf.QPdfDocument

This property holds the document to be viewed.

Access functions:

• document ()

• setDocument (document)

• Signal documentChanged (document)

property PᅟySide6.QtPdfWidgets.QPdfView.documentMargins: PySide6.QtCore.QMargins

This property holds the margins around the page view.

Access functions:

• documentMargins ()

• setDocumentMargins (margins)

• Signal documentMarginsChanged (documentMargins)

property PᅟySide6.QtPdfWidgets.QPdfView.pageMode: PageMode

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

Access functions:

• pageMode ()

• setPageMode (mode)

• Signal pageModeChanged (pageMode)

property PᅟySide6.QtPdfWidgets.QPdfView.pageSpacing: int

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

Access functions:

• pageSpacing ()

• setPageSpacing (spacing)

• Signal pageSpacingChanged (pageSpacing)

property PᅟySide6.QtPdfWidgets.QPdfView.zoomFactor: 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.

Access functions:

• zoomFactor ()

• setZoomFactor (factor)

• Signal zoomFactorChanged (zoomFactor)

property PᅟySide6.QtPdfWidgets.QPdfView.zoomMode: 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.

Access functions:

• zoomMode ()

• setZoomMode (mode)

• Signal zoomModeChanged (zoomMode)

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

See also

setDocument()

Getter of property document .

PySide6.QtPdfWidgets.QPdfView.documentChanged(document)

Parameters:

document – PySide6.QtPdf.QPdfDocument

Notification signal of property document .

PySide6.QtPdfWidgets.QPdfView.documentMargins()

Return type:

PySide6.QtCore.QMargins

See also

setDocumentMargins()

Getter of property documentMargins .

PySide6.QtPdfWidgets.QPdfView.documentMarginsChanged(documentMargins)

Parameters:

documentMargins – PySide6.QtCore.QMargins

Notification signal of property documentMargins .

PySide6.QtPdfWidgets.QPdfView.pageMode()

Return type:

PageMode

See also

setPageMode()

Getter of property pageMode .

PySide6.QtPdfWidgets.QPdfView.pageModeChanged(pageMode)

Parameters:

pageMode – PageMode

Notification signal of property pageMode .

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

See also

setPageSpacing()

Getter of property pageSpacing .

PySide6.QtPdfWidgets.QPdfView.pageSpacingChanged(pageSpacing)

Parameters:

pageSpacing – int

Notification signal of property pageSpacing .

PySide6.QtPdfWidgets.QPdfView.setDocument(document)

Parameters:

document – PySide6.QtPdf.QPdfDocument

See also

document()

Setter of property document .

PySide6.QtPdfWidgets.QPdfView.setDocumentMargins(margins)

Parameters:

margins – PySide6.QtCore.QMargins

See also

documentMargins()

Setter of property documentMargins .

PySide6.QtPdfWidgets.QPdfView.setPageMode(mode)

Parameters:

mode – PageMode

See also

pageMode()

Setter of property pageMode .

PySide6.QtPdfWidgets.QPdfView.setPageSpacing(spacing)

Parameters:

spacing – int

See also

pageSpacing()

Setter of property pageSpacing .

PySide6.QtPdfWidgets.QPdfView.setZoomFactor(factor)

Parameters:

factor – float

See also

zoomFactor()

Setter of property zoomFactor .

PySide6.QtPdfWidgets.QPdfView.setZoomMode(mode)

Parameters:

mode – ZoomMode

See also

zoomMode()

Setter of property zoomMode .

PySide6.QtPdfWidgets.QPdfView.zoomFactor()

Return type:

float

See also

setZoomFactor()

Getter of property zoomFactor .

PySide6.QtPdfWidgets.QPdfView.zoomFactorChanged(zoomFactor)

Parameters:

zoomFactor – float

Notification signal of property zoomFactor .

PySide6.QtPdfWidgets.QPdfView.zoomMode()

Return type:

ZoomMode

See also

setZoomMode()

Getter of property zoomMode .

PySide6.QtPdfWidgets.QPdfView.zoomModeChanged(zoomMode)

Parameters:

zoomMode – ZoomMode

Notification signal of property zoomMode .