Stampa di foto
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Scattare e condividere foto è uno degli usi più comuni dei dispositivi mobili. Se la tua applicazione
scatta foto, le visualizza o consente agli utenti di condividere le immagini, valuta la possibilità di attivare la stampa
di queste immagini nella tua applicazione. Android Support Library offre una pratica funzione per attivare la stampa di immagini utilizzando una
una quantità minima di codice e una semplice serie di opzioni di layout di stampa.
Questa lezione mostra come stampare un'immagine utilizzando il corso PrintHelper
della libreria di supporto v4.
Stampare un'immagine
Il corso PrintHelper
di Android Support Library offre
un modo semplice per stampare le immagini. Il corso ha una sola opzione di layout, setScaleMode()
,
che ti consente di stampare con una delle due opzioni seguenti:
SCALE_MODE_FIT
- Questo
ridimensiona l'immagine in modo che l'intera immagine venga visualizzata all'interno dell'area stampabile della pagina.
SCALE_MODE_FILL
- Questo
consente di ridimensionare l'immagine in modo da riempire l'intera area stampabile della pagina. In scelta
significa che alcune parti dei bordi superiore e inferiore o dei bordi sinistro e destro dell'immagine vengono
non viene stampato. Questa opzione è il valore predefinito se non imposti una modalità scala.
Entrambe le opzioni di ridimensionamento per setScaleMode()
mantengono invariate le proporzioni esistenti dell'immagine. Il seguente esempio di codice
mostra come creare un'istanza della classe PrintHelper
, impostare
di scalabilità e avviare il processo di stampa:
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);
}
Questo metodo può essere chiamato come azione per una voce di menu. Tieni presente che le voci di menu relative alle azioni
l'opzione non sempre supportata (ad esempio la stampa) deve essere inserita nel menu extra. Per ulteriori informazioni
informazioni, vedi il design della barra delle azioni
guida.
Dopo che il metodo printBitmap()
è
non sono richieste ulteriori azioni da parte dell'applicazione. Interfaccia utente di stampa di Android
che consente all'utente di selezionare una stampante e le opzioni di stampa. L'utente può quindi stampare
immagine o annulla l'azione. Se l'utente sceglie di stampare l'immagine, viene creato un processo di stampa e viene
una notifica di stampa nella barra di sistema.
Se vuoi includere contenuti aggiuntivi nei tuoi documenti cartacei oltre all'immagine, devi
creare un documento di stampa. Per informazioni sulla creazione di documenti da stampare, consulta le
Stampa di un documento HTML oppure
Stampa di un documento personalizzato
durante le lezioni.
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-07-27 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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."]]