Dtk::Widget::DPrintPreviewWidget类 参考

类 Dtk::Widget::DPrintPreviewWidget 继承关系图:

Public 类型
enum	Imposition {   One , OneRowTwoCol , TwoRowTwoCol , TwoRowThreeCol ,   ThreeRowThreeCol , FourRowFourCol }
enum	PageRange { AllPage , CurrentPage , SelectPage }
enum	Order {   L2R_T2B , R2L_T2B , T2B_L2R , T2B_R2L ,   Copy }
enum	PrintMode { PrintToPrinter , PrintToPdf , PrintToImage }

Public 槽
void	updatePreview ()
	刷新预览。
void	turnFront ()
	前翻一页。
void	turnBack ()
	后翻一页。
void	turnBegin ()
	第一页。
void	turnEnd ()
	最后一页。
void	setCurrentPage (int page)
	设置当前页。
void	print (bool isSavedPicture=false)
void	themeTypeChanged (DGuiApplicationHelper::ColorType themeType)

信号
void	paintRequested (DPrinter *printer)
void	paintRequested (DPrinter *printer, const QVector< int > &pageRange)
void	previewChanged ()
void	currentPageChanged (int page)
void	totalPages (int)
void	pagesCountChanged (int pages)

Public 成员函数
	DPrintPreviewWidget (DPrinter *printer, QWidget *parent=nullptr)
	构造一个 DPrintPreviewWidget。
void	setVisible (bool visible) override
	设置打印预览widget是否可见. \reimp
void	setPageRange (const QVector< int > &rangePages)
	预览是否改变，当预览改变时需要调用.
void	setPageRange (int from, int to)
	设置预览页面范围。
void	setPageRangeALL ()
	设置打印预览页面范围为所有页.
void	setPageRangeMode (PageRange mode)
	设置是否需要重新生成页面内容.
PageRange	pageRangeMode ()
	获取页面选择范围模式.
int	pagesCount ()
	获取预览总页数.
int	currentPage ()
	获取当前页的页码.
bool	turnPageAble ()
	获取是否可翻页.
void	setColorMode (const DPrinter::ColorMode &colorMode)
	设置色彩模式。
void	setOrientation (const DPrinter::Orientation &pageOrientation)
	设置页面方向。
DPrinter::ColorMode	getColorMode ()
	获取色彩模式。
void	setScale (qreal scale)
	设置页面缩放。
qreal	getScale () const
	获取缩放大小。
void	updateView ()
	刷新预览页面。
void	updateWaterMark ()
	强制刷新水印效果
void	refreshBegin ()
	水印刷新开始，主要用于同时多次调用水印属性改变的接口时，只刷新一次
void	refreshEnd ()
	水印刷新结束，刷新水印效果
void	setWaterMarkType (int type)
	设置水印类型。
void	setWaterMargImage (const QImage &image)
	设置水印图片。
void	setWaterMarkRotate (qreal rotate)
	设置水印旋转角度。
void	setWaterMarkScale (qreal scale)
	设置水印缩放大小。
void	setWaterMarkOpacity (qreal opacity)
	设置水印透明度。
void	setConfidentialWaterMark ()
	设置“绝密”文字水印。
void	setDraftWaterMark ()
	设置“草稿”文字水印。
void	setSampleWaterMark ()
	设置“样本”文字水印。
void	setCustomWaterMark (const QString &text)
	设置自定义文字水印。
void	setTextWaterMark (const QString &text)
	设置文字水印的文字内容。
void	setWaterMarkFont (const QFont &font)
	设置文字水印的字体。
QColor	waterMarkColor () const
	获取文字水印的颜色。
void	setWaterMarkColor (const QColor &color)
	设置文字水印的颜色。
void	setWaterMarkLayout (int layout)
	设置水印的布局。
void	setImposition (Imposition im)
	设置并打的模式。
Imposition	imposition () const
void	setOrder (Order order)
	设置页面内并打的顺序。
DPrintPreviewWidget::Order	order () const
void	setPrintFromPath (const QString &path)
QString	printFromPath () const
void	setPrintMode (PrintMode pt)
void	setAsynPreview (int totalPage)
bool	isAsynPreview () const
void	isPageByPage (int pageCopy, bool isFirst)
int	targetPageCount (int pageCount)
int	originPageCount ()
QByteArray	printerColorModel () const
Public 成员函数 继承自 Dtk::Widget::DFrame
	DFrame (QWidget *parent=nullptr)
	用于其他需要边框的控件基类
void	setFrameRounded (bool on)
	设置边框圆角是否开启
void	setBackgroundRole (DGUI_NAMESPACE::DPalette::ColorType type)
	设置边框背景画刷的种类

友元
class	ContentItem

额外继承的成员函数
Protected 成员函数 继承自 Dtk::Widget::DFrame
	DFrame (DFramePrivate &dd, QWidget *parent=nullptr)
void	paintEvent (QPaintEvent *event) override

详细描述

\inmodule dtkwidget

打印预览对话框界面中的视图预览窗口，用于预览来自第三方应用中的 数据。通常情况下应用无需调用该类中的接口，只需要在 DPrintPreviewDialog 中处理即可。除此之外，该类还管理了将预览数据输出到打印机的功能，例如，另存为 PDF、另存为图片等功能。

参见

Dtk::Widget::DPrintPreviewDialog

构造及析构函数说明

DPrintPreviewWidget()

Dtk::Widget::DPrintPreviewWidget::DPrintPreviewWidget ( DPrinter *  printer, QWidget *  parent = nullptr  )

explicit

构造一个 DPrintPreviewWidget。

printer 打印机 parent 父控件

成员函数说明

currentPage()

int Dtk::Widget::DPrintPreviewWidget::currentPage

(

)

获取当前页的页码.

返回

返回当前页的页码.

pageRangeMode()

DPrintPreviewWidget::PageRange Dtk::Widget::DPrintPreviewWidget::pageRangeMode

(

)

获取页面选择范围模式.

返回

返回页码返回的模式.

pagesCount()

int Dtk::Widget::DPrintPreviewWidget::pagesCount

(

)

获取预览总页数.

返回

返回预览总页数.

setColorMode()

void Dtk::Widget::DPrintPreviewWidget::setColorMode

(

const DPrinter::ColorMode &

colorMode

)

设置色彩模式。

colorMode 色彩模式

setCurrentPage

void Dtk::Widget::DPrintPreviewWidget::setCurrentPage ( int  page )

slot

设置当前页。

page 当前页

setCustomWaterMark()

void Dtk::Widget::DPrintPreviewWidget::setCustomWaterMark

(

const QString &

text

)

设置自定义文字水印。

text 自定义文字

setImposition()

void Dtk::Widget::DPrintPreviewWidget::setImposition

(

Imposition

im

)

设置并打的模式。

im 并打的模式

setOrder()

void Dtk::Widget::DPrintPreviewWidget::setOrder

(

Order

order

)

设置页面内并打的顺序。

order 页面内并打的顺序

setOrientation()

void Dtk::Widget::DPrintPreviewWidget::setOrientation

(

const DPrinter::Orientation &

pageOrientation

)

设置页面方向。

pageOrientation 页面方向

setPageRange() [1/2]

void Dtk::Widget::DPrintPreviewWidget::setPageRange

(

const QVector< int > &

rangePages

)

预览是否改变，当预览改变时需要调用.

generate 预览是否发生改变.

设置预览页面范围。

rangePages 页码Vector

setPageRange() [2/2]

void Dtk::Widget::DPrintPreviewWidget::setPageRange	(	int	from,
		int	to
	)

设置预览页面范围。

from 起始页码 to 终止页码

setPageRangeMode()

void Dtk::Widget::DPrintPreviewWidget::setPageRangeMode

(

PageRange

mode

)

设置是否需要重新生成页面内容.

generate 是否需要重新生成页面内容

设置页面选择范围模式。

mode 页面选择范围模式，AllPage所有页，CurrentPage当前页，SelectPage选择页

setScale()

void Dtk::Widget::DPrintPreviewWidget::setScale

(

qreal

scale

)

设置页面缩放。

scale 缩放大小

setTextWaterMark()

void Dtk::Widget::DPrintPreviewWidget::setTextWaterMark

(

const QString &

text

)

设置文字水印的文字内容。

text 文字水印的文字内容

setVisible()

void Dtk::Widget::DPrintPreviewWidget::setVisible ( bool  visible )

override

设置打印预览widget是否可见. \reimp

visible 是否可见

setWaterMargImage()

void Dtk::Widget::DPrintPreviewWidget::setWaterMargImage

(

const QImage &

image

)

设置水印图片。

image 水印图片

setWaterMarkColor()

void Dtk::Widget::DPrintPreviewWidget::setWaterMarkColor

(

const QColor &

color

)

设置文字水印的颜色。

color 文字水印的颜色

setWaterMarkFont()

void Dtk::Widget::DPrintPreviewWidget::setWaterMarkFont

(

const QFont &

font

)

设置文字水印的字体。

font 文字水印的字体

setWaterMarkLayout()

void Dtk::Widget::DPrintPreviewWidget::setWaterMarkLayout

(

int

layout

)

设置水印的布局。

layout 水印的布局，Center居中，Tiled平铺

setWaterMarkOpacity()

void Dtk::Widget::DPrintPreviewWidget::setWaterMarkOpacity

(

qreal

opacity

)

设置水印透明度。

opacity 水印透明度

setWaterMarkRotate()

void Dtk::Widget::DPrintPreviewWidget::setWaterMarkRotate

(

qreal

rotate

)

设置水印旋转角度。

rotate 水印旋转角度

setWaterMarkScale()

void Dtk::Widget::DPrintPreviewWidget::setWaterMarkScale

(

qreal

scale

)

设置水印缩放大小。

scale 水印缩放大小

setWaterMarkType()

void Dtk::Widget::DPrintPreviewWidget::setWaterMarkType

(

int

type

)

设置水印类型。

type 水印类型

turnPageAble()

bool Dtk::Widget::DPrintPreviewWidget::turnPageAble

(

)

获取是否可翻页.

返回

可翻页返回true,不可翻页返回false.

waterMarkColor()

QColor Dtk::Widget::DPrintPreviewWidget::waterMarkColor

(

)

const

获取文字水印的颜色。

返回

文字水印的颜色

---

该类的文档由以下文件生成:

• include/widgets/dprintpreviewwidget.h
• src/widgets/dprintpreviewwidget.cpp