【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打印界面就会出现，允许用户选择一个打印机和它的打印选项。之后用户就可以打印图像或者取消这一次操作。如果用户选择了打印图像，那么一个打印的任务就被创建了，并且一个打印的提醒通知会显示在系统的任务栏中。

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

【Android Developers Training】 52. 打印照片