com.supermap.layout
类 Printer

java.lang.Object
  继承者 com.supermap.layout.Printer

public class Printer
extends java.lang.Object

打印机类。

该类型仅在 Windows 平台版本中支持,在 Linux版本中不提供。


方法摘要
 int getCopies()
          返回要打印的副本数。
 int getDeviceDPI()
          返回打印机的 DPI。
 int getFromPage()
          返回要打印的起始页码。
 int getLogicDPI()
          返回布局打印处理时的逻辑 DPI,该值只在以栅格方式打印时使用。
 PaperMargin getMargin()
          返回页边对象。
 PaperOrientation getOrientation()
          返回打印纸面的朝向。
 double getPaperHeight()
          返回打印纸面的高度。
 PaperSize getPaperSize()
          返回打印页面大小。
 double getPaperWidth()
          返回打印纸面的宽度。
 java.lang.String getPrinterName()
          返回打印机的名称。
 java.lang.String getPrintFileName()
          返回打印文件的名称,该方法在将布局通过虚拟打印机打印时有效。
 int getToPage()
          返回要打印的结束页码。
 boolean isValidPrinter()
          返回打印机是否合法。
 boolean isVectorPrint()
          返回是否以矢量方式打印,true 表示以矢量方式打印,false 表示以栅格方式打印。
 void print()
          打印布局。
 void printWithDialog()
          通过弹出打印对话框的方式实现打印布局。
 void setCopies(int value)
          设置要打印的副本数,默认值为1。
 void setDeviceDPI(int value)
          设置打印机的DPI。
 void setFromPage(int value)
          设置要打印的起始页码。
 void setLogicDPI(int value)
          设置布局打印处理时的逻辑 DPI,该值只在以栅格方式打印时使用。
 void setMargin(PaperMargin paperMargin)
          设置页边对象。
 void setOrientation(PaperOrientation paperOrientation)
          设置打印纸面的朝向。
 void setPaperHeight(double value)
          设置打印纸面的高度。
 void setPaperSize(PaperSize size)
          设置打印页面大小。
 void setPaperWidth(double value)
          设置打印纸面的宽度。
 void setPrinterName(java.lang.String value)
          设置打印机的名称。
 void setPrintFileName(java.lang.String value)
          设置打印文件的名称,该方法在将布局通过虚拟打印机打印时有效。
 void setToPage(int value)
          设置要打印的结束页码。
 void setVectorPrint(boolean value)
          设置是否以矢量方式打印,true 表示以矢量方式打印,false 表示以栅格方式打印
 
从类 java.lang.Object 继承的方法
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

方法详细信息

getMargin

public PaperMargin getMargin()
返回页边对象。

返回:
页边对象。

setMargin

public void setMargin(PaperMargin paperMargin)
设置页边对象。

参数:
paperMargin - 页边对象

getPaperSize

public PaperSize getPaperSize()
返回打印页面大小。

返回:
打印页面大小。

setPaperSize

public void setPaperSize(PaperSize size)
设置打印页面大小。

参数:
size - 打印页面大小。

getOrientation

public PaperOrientation getOrientation()
返回打印纸面的朝向。

返回:
打印纸面的朝向。

setOrientation

public void setOrientation(PaperOrientation paperOrientation)
设置打印纸面的朝向。

参数:
paperOrientation - 打印纸面的朝向。

getCopies

public int getCopies()
返回要打印的副本数。

返回:
要打印的副本数。

setCopies

public void setCopies(int value)
设置要打印的副本数,默认值为1。

参数:
value - 要打印的副本数

isVectorPrint

public boolean isVectorPrint()
返回是否以矢量方式打印,true 表示以矢量方式打印,false 表示以栅格方式打印。

以矢量方式打印的速度要大大高于以栅格方式打印的速度,但是前者对于渐变或者半透明效果打印不出来,而栅格打印则可以打印出这些特殊效果。

返回:
true 表示以矢量方式打印,false 表示以栅格方式打印。

setVectorPrint

public void setVectorPrint(boolean value)
设置是否以矢量方式打印,true 表示以矢量方式打印,false 表示以栅格方式打印

参数:
value - 是否以矢量方式打印。

getLogicDPI

public int getLogicDPI()
返回布局打印处理时的逻辑 DPI,该值只在以栅格方式打印时使用。

返回:
布局打印处理时的逻辑 DPI。
默认值:
默认值为 200。

setLogicDPI

public void setLogicDPI(int value)
设置布局打印处理时的逻辑 DPI,该值只在以栅格方式打印时使用。

该方法主要用于布局打印时预处理栅格化,逻辑 DPI 与打印设备 DPI 越接近,打印效果越好。通常情况下,使用默认值 200 即可。当对打印效果要求较高时,可以将逻辑 DPI 的值设置成与打印设备的 DPI 一致。

此外,逻辑 DPI 越大,消耗的内存越多,速度会相应的减慢。设置该值消耗的内存的计算公式为:

消耗的内存 = 4*纸张的宽度*纸张的高度*DPI

其中,纸张的宽度、纸张的高度的单位为英尺,消耗的内存的单位为 Byte。

参数:
value - 布局打印处理时的逻辑 DPI。

getFromPage

public int getFromPage()
返回要打印的起始页码。

返回:
要打印的起始页码。

setFromPage

public void setFromPage(int value)
设置要打印的起始页码。

参数:
value - 要打印的起始页码。

getToPage

public int getToPage()
返回要打印的结束页码。

返回:
要打印的结束页码。

setToPage

public void setToPage(int value)
设置要打印的结束页码。

参数:
value - 要打印的结束页码。

getDeviceDPI

public int getDeviceDPI()
返回打印机的 DPI。

可以通过 Java 平台提供的 PrintServiceAttributeSet 接口得到当前打印机所支持的分辨率集合。

DPI 计算公式:DPI = 分辨率.X /纸张.X

其中,分辨率.X:表示 X 轴方向的分辨率,单位:像素;纸张.X:表示纸张 X 轴方向的长度,单位:英尺。

返回:
打印机的 DPI。

setDeviceDPI

public void setDeviceDPI(int value)
设置打印机的DPI。

参数:
value - 打印机的 DPI。

getPrinterName

public java.lang.String getPrinterName()
返回打印机的名称。

可以通过 PrinterJob.lookupPrintServices() 方法得到当前计算机所能连接到的打印机。

返回:
打印机的名称。

setPrinterName

public void setPrinterName(java.lang.String value)
设置打印机的名称。

参数:
value - 打印机的名称。

getPrintFileName

public java.lang.String getPrintFileName()
返回打印文件的名称,该方法在将布局通过虚拟打印机打印时有效。

返回:
打印文件的名称。

setPrintFileName

public void setPrintFileName(java.lang.String value)
设置打印文件的名称,该方法在将布局通过虚拟打印机打印时有效。

参数:
value - 打印文件的名称。

isValidPrinter

public boolean isValidPrinter()
返回打印机是否合法。

返回:
打印机是否合法。

print

public void print()
打印布局。


getPaperWidth

public double getPaperWidth()
返回打印纸面的宽度。单位为逻辑单位,即0.1mm,用于用户设置 PaperSizeUSERDEFINED 时候使用。

返回:
打印纸面的宽度。

setPaperWidth

public void setPaperWidth(double value)
设置打印纸面的宽度。单位为逻辑单位,即0.1mm,用于用户设置 PaperSizeUSERDEFINED 时候使用。

参数:
value - 打印纸面的宽度。

getPaperHeight

public double getPaperHeight()
返回打印纸面的高度。用于用户设置 PaperSizeUSERDEFINED 时候使用。

返回:
打印纸面的高度。

setPaperHeight

public void setPaperHeight(double value)
设置打印纸面的高度。

参数:
value - 打印纸面的高度。

printWithDialog

public void printWithDialog()
通过弹出打印对话框的方式实现打印布局。