列印相片

拍攝和分享相片是行動裝置最常用的一種方式。如果您的應用程式 拍照、顯示相片或允許使用者分享圖片，應考慮啟用列印功能 產生這類映像檔的映像檔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 文件或 列印自訂文件 課程。