【Android Developers Training】 52. 打印照片

注：本文翻译自Google官方的Android Developers Training文档，译者技术一般，由于喜爱安卓而产生了翻译的念头，纯属个人兴趣爱好。

原文链接：http://developer.android.com/training/printing/photos.html

拍摄并分享照片是移动设备最流行的用法之一。如果你的应用拍摄了照片，展示他们，或者允许用户共享照片，你就应该考虑在你的应用中可以打印他们。Android Support Library提供了一个方便的函数，它可以仅仅使用很少量的代码和一些简单的打印布局配置集，就能打印出照片来。

这堂课将向你展示如何使用v4 support library中的PrintHelper类来打印一幅图片。

一）. 打印一幅图片

Android Support Library中的PrintHelper类提供了一个打印图片的简单方法。这个类有一个简单的布局选项：setScaleMode()，它能允许你使用下面的两个选项之一：

SCALE_MODE_FIT：这个选项会调整图像大小，这样整个图像就会在打印有效区域内全部显示出来（缩放至长和宽都包含在纸张页面内）。
SCALE_MODE_FILL：这个选项同样会调整图像大小使图像充满整个打印有效区域，即让图像充满这个纸张页面。这就意味着如果选择这个区域，那么图片的一部分（顶部和底部，或者左侧和右侧）将无法打印出来。如果你不设置图像拉伸的选项，该模式将是默认的图像拉伸方式。

这两个setScaleMode()的图像缩放选项都会保持图像原有的长宽比。下面的代码展示了如何创建一个PrintHelper类的实例，设置缩放选项，并开始打印进程：

private void doPhotoPrint() {
    PrintHelper photoPrinter = new PrintHelper(getActivity());
    photoPrinter.setScaleMode(PrintHelper.SCALE_MODE_FIT);
    Bitmap bitmap = BitmapFactory.decodeResource(getResources(),
            R.drawable.droids);
    photoPrinter.printBitmap("droids.jpg - test print", bitmap);
}

这个方法可以作为一个菜单项的行为来被调用。注意对于那些不一定都能支持的菜单项（比如打印），应该放置在“更多菜单（overflow menu）”中。要获取更多知识，可以阅读：Action Bar这一设计指引。

在printBitmap()被调用之后，你的应用不再需要其他的操作了。之后Android打印界面就会出现，允许用户选择一个打印机和它的打印选项。之后用户就可以打印图像或者取消这一次操作。如果用户选择了打印图像，那么一个打印的任务就被创建了，并且一个打印的提醒通知会显示在系统的任务栏中。

如果你希望在你的打印输出中包含更多的内容，而不仅仅是一张图片，你就必须构造一个打印文档。这方面知识将会在后面的两节课程中展开。