返回一个 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)