写真の印刷
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
写真の撮影と共有は、モバイル デバイスの最も一般的な用途の 1 つです。アプリケーションが
写真を撮影して表示したり、ユーザーによる画像の共有を許可したりする場合には、印刷を有効にすることを検討する必要があります。
使用できますAndroid サポート ライブラリには、
必要最小限のコードとシンプルな印刷レイアウト オプションのセットです。
このレッスンでは、v4 サポート ライブラリ PrintHelper
クラスを使用して画像を印刷する方法について説明します。
画像を印刷する
Android サポート ライブラリの PrintHelper
クラスは、
簡単に画像を印刷できます。このクラスには単一のレイアウト オプション setScaleMode()
があります。
次の 2 つのオプションのいずれかで印刷できます
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);
}
このメソッドは、メニュー項目のアクションとして呼び出すことができます。アクションのメニュー項目は、Google Cloud の
(印刷など)常にサポートされないものは、オーバーフロー メニューに配置してください。詳細
アクションバーのデザインをご覧ください。
ご覧ください
printBitmap()
メソッドの
アプリケーションで追加のアクションを実行する必要はありません。Android の印刷ユーザー インターフェース
が表示され、ユーザーはプリンタや印刷オプションを選択できます。その後、ユーザーは
アクションをキャンセルします。ユーザーが画像の印刷を選択すると、印刷ジョブが作成され、
印刷の通知が表示されます。
画像以外のコンテンツをプリントアウトに含める場合は、
出力ドキュメントを作成します。印刷するドキュメントの作成方法については、
HTML ドキュメントの印刷
カスタム ドキュメントの印刷
学びました。
このページのコンテンツやコードサンプルは、コンテンツ ライセンスに記載のライセンスに従います。Java および OpenJDK は Oracle および関連会社の商標または登録商標です。
最終更新日 2025-07-27 UTC。
[null,null,["最終更新日 2025-07-27 UTC。"],[],[],null,["# Printing photos\n\nTaking and sharing photos is one of the most popular uses for mobile devices. If your application\ntakes photos, displays them, or allows users to share images, you should consider enabling printing\nof those images in your application. The [Android Support Library](/tools/support-library) provides a convenient function for enabling image printing using a\nminimal amount of code and simple set of print layout options.\n\nThis lesson shows you how to print an image using the v4 support library [PrintHelper](/reference/androidx/print/PrintHelper) class.\n\nPrint an image\n--------------\n\nThe Android Support Library [PrintHelper](/reference/androidx/print/PrintHelper) class provides\na simple way to print images. The class has a single layout option, [setScaleMode()](/reference/androidx/print/PrintHelper#setScaleMode(int)),\nwhich allows you to print with one of two options:\n\n- [SCALE_MODE_FIT](/reference/androidx/print/PrintHelper#SCALE_MODE_FIT) - This option sizes the image so that the whole image is shown within the printable area of the page.\n- [SCALE_MODE_FILL](/reference/androidx/print/PrintHelper#SCALE_MODE_FILL) - This option scales the image so that it fills the entire printable area of the page. Choosing this setting means that some portion of the top and bottom, or left and right edges of the image is not printed. This option is the default value if you do not set a scale mode.\n\nBoth scaling options for [setScaleMode()](/reference/androidx/print/PrintHelper#setScaleMode(int)) keep the existing aspect ratio of the image intact. The following code example\nshows how to create an instance of the [PrintHelper](/reference/androidx/print/PrintHelper) class, set the\nscaling option, and start the printing process: \n\n### Kotlin\n\n```kotlin\nprivate fun doPhotoPrint() {\n activity?.also { context -\u003e\n PrintHelper(context).apply {\n scaleMode = PrintHelper.SCALE_MODE_FIT\n }.also { printHelper -\u003e\n val bitmap = BitmapFactory.decodeResource(resources, R.drawable.droids)\n printHelper.printBitmap(\"droids.jpg - test print\", bitmap)\n }\n }\n}\n```\n\n### Java\n\n```java\nprivate void doPhotoPrint() {\n PrintHelper photoPrinter = new PrintHelper(getActivity());\n photoPrinter.setScaleMode(PrintHelper.SCALE_MODE_FIT);\n Bitmap bitmap = BitmapFactory.decodeResource(getResources(),\n R.drawable.droids);\n photoPrinter.printBitmap(\"droids.jpg - test print\", bitmap);\n}\n```\n\n\nThis method can be called as the action for a menu item. Note that menu items for actions that are\nnot always supported (such as printing) should be placed in the overflow menu. For more\ninformation, see the [Action Bar](/design/patterns/actionbar) design\nguide.\n\nAfter the [printBitmap()](/reference/androidx/print/PrintHelper#printBitmap(java.lang.String, android.graphics.Bitmap)) method is\ncalled, no further action from your application is required. The Android print user interface\nappears, allowing the user to select a printer and printing options. The user can then print the\nimage or cancel the action. If the user chooses to print the image, a print job is created and a\nprinting notification appears in the system bar.\n\nIf you want to include additional content in your printouts beyond just an image, you must\nconstruct a print document. For information on creating documents for printing, see the\n[Printing an HTML document](/training/printing/html-docs) or\n[Printing a custom document](/training/printing/custom-docs)\nlessons."]]