java命名空间java.awt类toolkit的类成员方法:
getprintjob定义及介绍
本文导语:
getprintjob
public printjob getprintjob(frame frame,
string jobtitle,
jobattributes jobattributes,
pageattributes pageattributes)
获取一个 printjob 对象,该对象是在工具包平台上初始化某个...
getprintjob
public printjob getprintjob(frame frame,
string jobtitle,
jobattributes jobattributes,
pageattributes pageattributes)
- 获取一个
printjob
对象,该对象是在工具包平台上初始化某个打印操作的结果。
此方法的每个实际实现都应该先检查是否安装了安全管理器。如果安装了安全管理器,则该方法应该调用安全管理器的 checkprintjobaccess
方法,以确保允许初始化打印操作。如果使用 checkprintjobaccess
的默认实现(即未重写该方法),则将导致使用 runtimepermission("queueprintjob")
权限调用安全管理器的 checkpermission
方法。
- 参数:
frame
- 打印对话框的父级。当且仅当 jobattributes 不为 null 且 jobattributes.getdialog() 返回 jobattributes.dialogtype.none 或 jobattributes.dialogtype.common 时,该参数可为 null。jobtitle
- printjob 的标题。null 标题等同于 ""。jobattributes
- 控制 printjob 的作业属性集合。这些属性将被更新,以反映用户的选择,这概括在 jobattributes 文档中。可以为 null。pageattributes
- 控制 printjob 的页面属性集合。这些属性将应用于作业中的每个页面。这些属性将被更新,以反映用户的选择,这概括在 pageattributes 文档中。可以为 null。
- 返回:
- 一个
printjob
对象;如果用户取消打印作业,则返回 null
。
- 抛出:
nullpointerexception
- 如果 frame 为 null,并且 jobattributes 为 null 或者 jobattributes.getdialog() 返回 jobattributes.dialogtype.native。
illegalargumentexception
- 如果 pageattributes 通过馈送然后解析馈送这一过程来指定不同之处。如果此线程可访问文件系统且 jobattributes 指定打印到文件,则出现以下情况时也将抛出该异常:指定目标文件存在但它是一个目录而不是常规文件;指定目标文件不存在但不能创建;指定目标文件由于某些其他原因无法打开。但是,在指定打印到文件的情况下,如果同时请求了显示对话框,那么用户将有机会选择一个文件并继续打印。在从此方法返回前,该对话框将保证选择的输出文件有效。
graphicsenvironment.isheadless() 返回 true 时总是抛出此异常。
securityexception
- 如果此线程不允许初始化打印作业请求,或者 jobattributes 指定打印到文件,并且此线程不允许访问该文件系统- 从以下版本开始:
- 1.3
- 另请参见:
printjob
,
graphicsenvironment.isheadless()
,
runtimepermission
,
jobattributes
,
pageattributes