如何打印表格

1. 点击"启动"按钮，使用Java™ Web Start 运行TablePrintDemo1（下载JDK 7或更高版本）。或者，如果你想要自己编译和运行示例，请参考示例索引。
   
2. 应用程序窗口底部的每个复选框都有工具提示。将鼠标悬停在复选框上，以了解其用途。
3. 编辑“头部”或“底部”复选框中的文本，或同时编辑两者，以提供不同的页眉或页脚。
4. 清除“头部”或“底部”复选框中的选中状态，以关闭页眉或页脚。
5. 清除“显示打印对话框”复选框，以关闭打印对话框。
6. 清除“适应打印页面宽度”复选框，以选择在“NORMAL”模式下打印。
7. 清除“交互式（显示状态对话框）”复选框，以关闭打印对话框。
8. 点击“打印”按钮，根据所选选项打印表格。

每当一个通过Web启动的应用程序尝试进行打印时，Java Web Start会弹出一个安全对话框，询问用户是否允许打印。要继续打印，用户必须接受请求。

请注意，当你清除“交互式”复选框时，会出现一个警告消息，提醒用户打印非交互式的劣势。你可以在PrintGradesTable方法中找到打印代码。当调用此方法时，首先从GUI组件中获取选定选项的集合，然后调用print方法，如下所示。

boolean complete = gradesTable.print(mode, header, footer,
                                     showPrintDialog, null,
                                     interactive, null);

print方法返回的值被用来显示成功消息或用户取消打印的消息。

另一个重要的功能是表格打印API使用表格渲染器。通过使用表格的渲染器，API提供了一个打印输出，其外观与屏幕上的表格相同。看一下屏幕上表格的最后一列。它包含了每个学生的通过或不通过状态的自定义图像。现在看一下打印结果。你会发现，勾号和叉号看起来是一样的。

下面是TablePrintDemo1在FIT_WIDTH模式下的打印结果的图片。

此图片已缩小以适应页面。
点击图片以查看其原始大小。

TablePrintDemo2示例

TablePrintDemo2示例是基于上一个示例的，并且具有相同的界面。唯一的区别在于打印输出结果。如果你仔细观察TablePrintDemo1的打印结果，你可能会注意到勾号和X号模糊不清。TablePrintDemo2示例展示了如何自定义表格以使图像在表格打印中更加清晰可辨。在此示例中，重写的getTableCellRendererComponent方法判断表格是否正在打印，并返回更清晰的黑白图像。如果表格没有在打印，它返回在屏幕上可见的彩色图像。

点击“启动”按钮使用Java™ Web Start（下载JDK 7或更高版本）运行TablePrintDemo2。或者，要自己编译和运行示例，请参考示例索引。

JComponent类中定义的isPaintingForPrint方法允许我们根据打印和屏幕显示的差异来自定义打印内容。下面是自定义单元格渲染器的代码，取自TablePrintDemo2.java。这段代码根据isPaintingForPrint方法的返回值选择使用哪些图像。

    /**
     * 一个自定义单元格渲染器，继承自TablePrintDemo1的渲染器，用于在打印时使用更清晰的黑白图标。
     */
    protected static class BWPassedColumnRenderer extends PassedColumnRenderer {
            public Component getTableCellRendererComponent(JTable table,
                                                           Object value,
                                                           boolean isSelected,
                                                           boolean hasFocus,
                                                           int row,
                                                           int column) {

            super.getTableCellRendererComponent(table, value, isSelected,
                                                hasFocus, row, column);

            /* 如果当前正在打印，则使用黑白图标 */
            if (table.isPaintingForPrint()) {
                boolean status = (Boolean)value;
                setIcon(status ? passedIconBW : failedIconBW);
            } /* 否则，使用父类（彩色）图标 */

            return this;
        }
    }

这是TablePrintDemo2打印结果的图片，使用FIT_WIDTH模式。

这张图片已经缩小以适应页面。
点击图片以查看其原始大小。

TablePrintDemo3示例

TablePrintDemo3示例基于前两个演示。此示例展示了如何通过包装默认的Printable来提供自定义的Printable实现。此演示具有类似的界面，但标题和页脚的复选框被禁用，因为自定义的可打印对象将提供自己的标题和页脚。

点击“启动”按钮使用Java™ Web Start 运行TablePrintDemo3（下载JDK 7或更高版本）。或者，要自己编译和运行示例，请参考示例索引。

此示例将表格打印在剪贴板的图像内。这是TablePrintDemo3示例的打印结果的图片，使用FIT_WIDTH模式。

这张图片已经缩小以适应页面。
点击图片以查看其原始大小。

此程序的完整代码可以在TablePrintDemo3.java中找到。在此演示中，使用了一个名为FancyPrintingJTable的JTable类的自定义子类。这个FancyPrintingJTable类重写了getPrintable方法，返回一个自定义的可打印对象，该对象包装了默认的可打印对象，并带有自己的装饰、标题和页脚。下面是getPrintable方法的实现。

public Printable getPrintable(PrintMode printMode,
                              MessageFormat headerFormat,
                              MessageFormat footerFormat) {

     MessageFormat pageNumber = new MessageFormat("- {0} -");

     /* 获取默认的可打印对象 */
     Printable delegate = super.getPrintable(printMode, null, pageNumber);

     /* 返回一个包装默认可打印对象的精美可打印对象 */
     return new FancyPrintable(delegate);
}

FancyPrintable类负责将默认的可打印对象包装成另一个可打印对象，并设置剪贴板图像。当实例化这个类的一个实例时，它会加载组装剪贴板图像所需的图像，计算剪贴板图像所需的区域，计算表格的缩小区域，将表格打印到较小的区域，并组装和打印剪贴板图像。

请注意，组装剪贴板图像的代码对于页面大小的灵活性。代码考虑了实际页面的尺寸，并组合辅助图像，根据需要拉伸其中一些图像，以使最终的剪贴板图像适合实际页面大小。下图显示了辅助图像并指示这些图像如何组成最终的输出。

此图已缩小以适应页面。
点击图片查看其原始大小。

表格打印API

本节列出了JTable类中定义的允许您打印表格的方法。

使用表格打印的示例

这个表格列出了使用表格打印的示例，并指向了这些示例所描述的位置。