拍摄并分享照片是移动设备最流行的用法之一。如果你的应用拍摄了照片,展示他们,或者允许用户共享照片,你就应该考虑在你的应用中可以打印他们。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打印界面就会出现,允许用户选择一个打印机和它的打印选项。之后用户就可以打印图像或者取消这一次操作。如果用户选择了打印图像,那么一个打印的任务就被创建了,并且一个打印的提醒通知会显示在系统的任务栏中。
如果你希望在你的打印输出中包含更多的内容,而不仅仅是一张图片,你就必须构造一个打印文档。这方面知识将会在后面的两节课程中展开。