返回一个 printable
,用于打印此 jtextcomponent
的内容。返回的 printable
以文档在屏幕上呈现的外形对该文档进行打印,为了符合纸张标准重新格式化时除外。返回的 printable
可包装于另一个 printable
内,以便创建复杂的报告和文档。
返回的 printable
与此 jtextcomponent
共享 document
。开发人员确保使用此 printable
时不改变 document
。打印期间改变 document
将导致不确定的打印行为。
通过提供 messageformat
参数可以将页面标题和脚注文本添加到输出。打印代码从格式中请求 string
,提供可能包含于格式化字符串中的单个项:表示当前页数的 integer
。
打印时,返回的 printable
对文档内容进行适当地格式化以适合页面大小。为了能正确的自动换行,所有页面的 imageable width
必须相同。请参阅 pageformat.getimageablewidth()
。
虽然大多数 swing 方法不是线程安全的,但此方法是线程安全的。有关更多信息,请参阅 how to use threads。
可以在任意线程上打印返回的 printable
。
返回 printable
的此实现在事件指派线程 上执行所有打印,而不管是在什么线程上使用它。
- 参数:
headerformat
- 在 messageformat
中用作标题的文本,或者为 null
,表示没有标题footerformat
- 在 messageformat
中用作脚注的文本,或者为 null
,表示没有脚注
- 返回:
- 打印此
jtextcomponent
内容时使用的 printable
- 从以下版本开始:
- 1.6
- 另请参见:
printable
,
pageformat
,
document.render(java.lang.runnable)