拍攝和分享相片是行動裝置最常用的一種方式。如果您的應用程式 拍照、顯示相片或允許使用者分享圖片,應考慮啟用列印功能 產生這類映像檔的映像檔Android 支援資料庫提供了一個便利的功能,可讓您使用 並具備精簡的列印版面配置選項。
本課程將說明如何使用 v4 支援資料庫 PrintHelper
類別列印圖片。
列印圖片
Android 支援資料庫 PrintHelper
類別提供了
輕鬆列印圖片這個類別有單一版面配置選項 setScaleMode()
、
它可讓您使用以下兩種選項之一列印:
SCALE_MODE_FIT
- 這項 選項會調整圖片的大小,讓整個圖片顯示在頁面中的可列印區域。SCALE_MODE_FILL
- 這項 選項會縮放圖片,使其填滿網頁的整個可列印區域。選擇此項目 設定後,圖片的上、下、左、右邊緣 因此無法列印。若未設定縮放模式,此選項為預設值。
setScaleMode()
的縮放選項都會保留圖片現有的長寬比。以下程式碼範例
說明如何建立 PrintHelper
類別的執行個體、設定
,然後開始列印程序:
Kotlin
private fun doPhotoPrint() { activity?.also { context -> PrintHelper(context).apply { scaleMode = PrintHelper.SCALE_MODE_FIT }.also { printHelper -> val bitmap = BitmapFactory.decodeResource(resources, R.drawable.droids) printHelper.printBitmap("droids.jpg - test print", bitmap) } } }
Java
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); }
此方法可呼叫為選單項目的動作。請注意,這類動作的選單項目 並非一律支援的功能 (例如列印) 都放在溢位選單中。如要 相關資訊,請參閱動作列設計 指南。
printBitmap()
方法之後
,您不需要在應用程式中採取任何進一步行動。Android 列印使用者介面
,可讓使用者選取印表機和列印選項。使用者即可將
圖片或取消動作如果使用者選擇列印圖片,系統會建立列印工作,並
列印通知就會出現在系統列上。
如果除了圖片之外,如要一併列印其他內容,您必須 輸出文件如要進一步瞭解如何建立列印文件,請參閱 列印 HTML 文件或 列印自訂文件 課程。