QPrintPreviewWidget Class Reference · PyQt4 中文文檔

# QPrintPreviewWidget Class Reference ## [[QtGui](index.htm) module] 該QPrintPreviewWidget類提供了一個小工具可以預覽頁面布局打印輸出。[More...](#details) 繼承[QWidget](qwidget.html)。 ### Types * `enum ViewMode { SinglePageView, FacingPagesView, AllPagesView }` * `enum ZoomMode { CustomZoom, FitToWidth, FitInView }` ### Methods * `__init__ (self, QPrinter?printer, QWidget?parent?=?None, Qt.WindowFlags?flags?=?0)` * `__init__ (self, QWidget?parent?=?None, Qt.WindowFlags?flags?=?0)` * `int currentPage (self)` * `fitInView (self)` * `fitToWidth (self)` * `int numPages (self)` * `QPrinter.Orientation orientation (self)` * `int pageCount (self)` * `print_ (self)` * `setAllPagesViewMode (self)` * `setCurrentPage (self, int?pageNumber)` * `setFacingPagesViewMode (self)` * `setLandscapeOrientation (self)` * `setOrientation (self, QPrinter.Orientation?orientation)` * `setPortraitOrientation (self)` * `setSinglePageViewMode (self)` * `setViewMode (self, ViewMode?viewMode)` * `setVisible (self, bool?visible)` * `setZoomFactor (self, float?zoomFactor)` * `setZoomMode (self, ZoomMode?zoomMode)` * `updatePreview (self)` * `ViewMode viewMode (self)` * `float zoomFactor (self)` * `zoomIn (self, float?factor?=?1.1)` * `ZoomMode zoomMode (self)` * `zoomOut (self, float?factor?=?1.1)` ### Qt Signals * `void paintRequested (QPrinter *)` * `void previewChanged ()` * * * ## Detailed Description 該QPrintPreviewWidget類提供了一個小工具可以預覽頁面布局打印輸出。 [QPrintPreviewDialog](qprintpreviewdialog.html)使用QPrintPreviewWidget內部，并QPrintPreviewWidget的目的是使得有可能以嵌入的預覽到其它部件。這也使得它能夠圍繞它一個不同的用戶界面比默認設置有[QPrintPreviewDialog](qprintpreviewdialog.html)。使用QPrintPreviewWidget很簡單： 1. 創建QPrintPreviewWidget 通過傳遞一個現有的構造QPrintPreviewWidget要么[QPrinter](qprinter.html)對象，或者已QPrintPreviewWidget創建構建的默認[QPrinter](qprinter.html)反對你。 2. 連接[paintRequested](qprintpreviewwidget.html#paintRequested)（）信號到一個槽。當插件需要產生一組預覽頁面，一個[paintRequested](qprintpreviewwidget.html#paintRequested)（）信號將被從部件射出。槽連接到這個信號，并繪制到[QPrinter](qprinter.html)通過在作為信號參數。通話[QPrinter.newPage](qprinter.html#newPage)（），以在預覽啟動一個新的頁面。 * * * ## Type Documentation ``` QPrintPreviewWidget.ViewMode ``` 此枚舉是用來描述在預覽窗口小部件的視圖模式。 | Constant | Value | Description | | --- | --- | --- | | `QPrintPreviewWidget.SinglePageView` | `0` | A模式，其中單頁在預覽中查看。 | | `QPrintPreviewWidget.FacingPagesView` | `1` | 凡在預覽中的對開頁面被觀看的模式。 | | `QPrintPreviewWidget.AllPagesView` | `2` | 凡在預覽所有頁面中查看視圖模式。 | ``` QPrintPreviewWidget.ZoomMode ``` 該枚舉用于描述在預覽窗口小部件的縮放模式。 | Constant | Value | Description | | --- | --- | --- | | `QPrintPreviewWidget.CustomZoom` | `0` | 變焦被設置為自定義縮放值。 | | `QPrintPreviewWidget.FitToWidth` | `1` | 這種模式下的當前頁面適合于該視圖的寬度。 | | `QPrintPreviewWidget.FitInView` | `2` | 這種模式在當前頁的視圖內適合。 | * * * ## Method Documentation ``` QPrintPreviewWidget.__init__ (self, QPrinter?printer, QWidget?parent?=?None, Qt.WindowFlags?flags?=?0) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個[QPrintPreviewWidget](qprintpreviewwidget.html)基于_printer_并與_parent_作為父控件。窗口部件標記_flags_到傳遞[QWidget](qwidget.html)構造函數。 **See also** [QWidget.setWindowFlags](qwidget.html#windowFlags-prop)（）。 ``` QPrintPreviewWidget.__init__ (self, QWidget?parent?=?None, Qt.WindowFlags?flags?=?0) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。這是一個重載函數。這將導致[QPrintPreviewWidget](qprintpreviewwidget.html)創建構造內部，默認[QPrinter](qprinter.html)對象，該對象將被用于生成預覽。 ``` int QPrintPreviewWidget.currentPage (self) ``` 返回當前瀏覽的頁面的預覽。 **See also** [setCurrentPage](qprintpreviewwidget.html#setCurrentPage)（）。 ``` QPrintPreviewWidget.fitInView (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void fitInView()`。這是一個方便的功能，是與調用`setZoomMode(QPrintPreviewWidget.FitInView)`。 ``` QPrintPreviewWidget.fitToWidth (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void fitToWidth()`。這是一個方便的功能，是與調用`setZoomMode(QPrintPreviewWidget.FitToWidth)`。 ``` int QPrintPreviewWidget.numPages (self) ``` ``` QPrinter.Orientation QPrintPreviewWidget.orientation (self) ``` [](qprinter.html#Orientation-enum) [返回預覽的當前方向。從該值是](qprinter.html#Orientation-enum)[QPrinter](qprinter.html)與預覽相關聯的對象。 **See also** [setOrientation](qprintpreviewwidget.html#setOrientation)（）。 ``` int QPrintPreviewWidget.pageCount (self) ``` 返回在預覽的頁數。此功能被引入Qt的4.6 。 ``` QPrintPreviewWidget.print_ (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void print()`。打印預覽與預覽相關聯的打印機。 ``` QPrintPreviewWidget.setAllPagesViewMode (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void setAllPagesViewMode()`。這是一個方便的功能，是與調用`setViewMode(QPrintPreviewWidget.AllPagesView)`。 ``` QPrintPreviewWidget.setCurrentPage (self, int?pageNumber) ``` 這種方法也是一個Qt槽與C + +的簽名`void setCurrentPage(int)`。設置在預覽當前頁面。這將導致以跳到開頭_page_。 **See also** [currentPage](qprintpreviewwidget.html#currentPage)（）。 ``` QPrintPreviewWidget.setFacingPagesViewMode (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void setFacingPagesViewMode()`。這是一個方便的功能，是與調用`setViewMode(QPrintPreviewWidget.FacingPagesView)`。 ``` QPrintPreviewWidget.setLandscapeOrientation (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void setLandscapeOrientation()`。這是一個方便的功能，是與調用`setOrientation(QPrinter.Landscape)`。 ``` QPrintPreviewWidget.setOrientation (self, QPrinter.Orientation?orientation) ``` 這種方法也是一個Qt槽與C + +的簽名`void setOrientation(QPrinter::Orientation)`。設置當前的取向_orientation_。此值將在設置[QPrinter](qprinter.html)與預覽相關聯的對象。 **See also** [orientation](qprintpreviewwidget.html#orientation)（）。 ``` QPrintPreviewWidget.setPortraitOrientation (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void setPortraitOrientation()`。這是一個方便的功能，是與調用`setOrientation(QPrinter.Portrait)`。 ``` QPrintPreviewWidget.setSinglePageViewMode (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void setSinglePageViewMode()`。這是一個方便的功能，是與調用`setViewMode(QPrintPreviewWidget.SinglePageView)`。 ``` QPrintPreviewWidget.setViewMode (self, ViewMode?viewMode) ``` 這種方法也是一個Qt槽與C + +的簽名`void setViewMode(QPrintPreviewWidget::ViewMode)`。設置視圖模式_mode_。默認視圖模式[SinglePageView](qprintpreviewwidget.html#ViewMode-enum)。 **See also** [viewMode](qprintpreviewwidget.html#viewMode)（）。 ``` QPrintPreviewWidget.setVisible (self, bool?visible) ``` 這種方法也是一個Qt槽與C + +的簽名`void setVisible(bool)`。從重新實現[QWidget.setVisible](qwidget.html#visible-prop)（）。 ``` QPrintPreviewWidget.setZoomFactor (self, float?zoomFactor) ``` 這種方法也是一個Qt槽與C + +的簽名`void setZoomFactor(qreal)`。設置視圖的縮放因子_factor_。例如，值1.0表示縮放的觀點，這大約是認為不會對紙張的尺寸。 0.5的值將減半視圖的大小，而2.0的值將增加一倍視圖的大小。 **See also** [zoomFactor](qprintpreviewwidget.html#zoomFactor)（）。 ``` QPrintPreviewWidget.setZoomMode (self, ZoomMode?zoomMode) ``` 這種方法也是一個Qt槽與C + +的簽名`void setZoomMode(QPrintPreviewWidget::ZoomMode)`。設置縮放模式_zoomMode_。默認縮放模式[FitInView](qprintpreviewwidget.html#ZoomMode-enum)。 **See also** [zoomMode](qprintpreviewwidget.html#zoomMode)（）[viewMode](qprintpreviewwidget.html#viewMode)（）和[setViewMode](qprintpreviewwidget.html#setViewMode)（）。 ``` QPrintPreviewWidget.updatePreview (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void updatePreview()`。這個函數更新預覽，這會導致[paintRequested](qprintpreviewwidget.html#paintRequested)（）信號被發射。 ``` ViewMode QPrintPreviewWidget.viewMode (self) ``` [](qprintpreviewwidget.html#ViewMode-enum) [返回當前視圖模式。默認視圖模式](qprintpreviewwidget.html#ViewMode-enum)[SinglePageView](qprintpreviewwidget.html#ViewMode-enum)。 **See also** [setViewMode](qprintpreviewwidget.html#setViewMode)（）。 ``` float QPrintPreviewWidget.zoomFactor (self) ``` 返回視圖的縮放因子。 **See also** [setZoomFactor](qprintpreviewwidget.html#setZoomFactor)（）。 ``` QPrintPreviewWidget.zoomIn (self, float?factor?=?1.1) ``` 這種方法也是一個Qt槽與C + +的簽名`void zoomIn(qreal = 1.1)`。縮放當前視圖中所_factor_。為默認值_factor_是1.1 ，這意味著該視圖將被縮小了10 ％。 ``` ZoomMode QPrintPreviewWidget.zoomMode (self) ``` [ 返回當前的縮放模式。 ](qprintpreviewwidget.html#ZoomMode-enum) [**See also**](qprintpreviewwidget.html#ZoomMode-enum) [setZoomMode](qprintpreviewwidget.html#setZoomMode)（）[viewMode](qprintpreviewwidget.html#viewMode)（）和[setViewMode](qprintpreviewwidget.html#setViewMode)（）。 ``` QPrintPreviewWidget.zoomOut (self, float?factor?=?1.1) ``` 這種方法也是一個Qt槽與C + +的簽名`void zoomOut(qreal = 1.1)`。縮放當前視圖由_factor_。為默認值_factor_是1.1 ，這意味著該視圖將增加10 ％，按比例縮小。 * * * ## Qt Signal Documentation ``` void paintRequested (QPrinter *) ``` 這是該信號的默認超載。當預覽窗口小部件需要產生一組預覽頁面這個信號被發射。_printer_與此預覽插件的打印機相關聯。 ``` void previewChanged () ``` 這是該信號的默認超載。這個信號被發射時在預覽窗口部件已經改變了一些內部狀態，如取向。