- Xamarin Tutorial
- Printing custom documents
- Xamarin tutorial android pdf printer
- How to Print to PDF for Android
- Steps for Printing to PDF on Android Devices
- Xamarin Android Tutorial - Create PDF File and Print
- Create a print adapter
- Printing from a Xamarin.Android Application Developed with Visual Studio
- Print PDF file
For some applications, such as drawing apps, page layout apps and other apps that focus on graphic output, creating beautiful printed pages is a key feature.
In this case, it is not enough to print an image or an HTML document. The print output for these types of applications requires precise control of everything that goes into a page, including fonts, text flow, page breaks, headers, footers, and graphic elements.
Creating print output that is completely customized for your application requires more programming investment than the previously discussed approaches. You must build components that communicate with the print framework, adjust to printer settings, draw page elements and manage printing on multiple pages.
This lesson shows you how you connect with the print manager, create a print adapter and build content for printing. When your application manages the printing process directly, the first step after receiving a print request from your user is to connect to the Android print framework and obtain an instance of the PrintManager class.
This class allows you to initialize a print job and begin the printing lifecycle. The following code example shows how to get the print manager and start the printing process. The example code above demonstrates how to name a print job and set an instance of the PrintDocumentAdapter class which handles the steps of the printing lifecycle. The implementation of the print adapter class is discussed in the next section.
Note: The last parameter in the print method takes a PrintAttributes object. You can use this parameter to provide hints to the printing framework and pre-set options based on the previous printing cycle, thereby improving the user experience. You may also use this parameter to set options that are more appropriate to the content being printed, such as setting the orientation to landscape when printing a photo that is in that orientation.
A print adapter interacts with the Android print framework and handles the steps of the printing process. This process requires users to select printers and print options before creating a document for printing.
These selections can influence the final output as the user chooses printers with different output capabilities, different page sizes, or different page orientations. As these selections are made, the print framework asks your adapter to lay out and generate a print document, in preparation for final output.
Once a user taps the print button, the framework takes the final print document and passes it to a print provider for output. During the printing process, users can choose to cancel the print action, so your print adapter must also listen for and react to a cancellation requests.
The PrintDocumentAdapter abstract class is designed to handle the printing lifecycle, which has four main callback methods.
You must implement these methods in your print adapter in order to interact properly with the print framework:. The following sections describe how to implement the layout and write methods, which are critical to the functioning of a print adapter. Note: These adapter methods are called on the main thread of your application. If you expect the execution of these methods in your implementation to take a significant amount of time, implement them to execute within a separate thread.
For example, you can encapsulate the layout or print document writing work in separate AsyncTask objects.
Printing custom documents
Within an implementation of the PrintDocumentAdapter class, your application must be able to specify the type of document it is creating and calculate the total number of pages for print job, given information about the printed page size. The implementation of the onLayout method in the adapter makes these calculations and provides information about the expected output of the print job in a PrintDocumentInfo class, including the number of pages and content type.
The following code example shows a basic implementation of the onLayout method for a PrintDocumentAdapter : Kotlin override fun onLayout oldAttributes: PrintAttributes?
You must indicate one of these results by calling the appropriate method of the PrintDocumentAdapter. LayoutResultCallback object. Note: The boolean parameter of the onLayoutFinished method indicates whether or not the layout content has actually changed since the last request. Setting this parameter properly allows the print framework to avoid unnecessarily calling the onWrite method, essentially caching the previously written print document and improving performance.
Xamarin tutorial android pdf printer
The main work of onLayout is calculating the number of pages that are expected as output given the attributes of the printer. How you calculate this number is highly dependent on how your application lays out pages for printing. The following code example shows an implementation where the number of pages is determined by the print orientation:.
When it is time to write print output to a file, the Android print framework calls the onWrite method of your application's PrintDocumentAdapter class. The method's parameters specify which pages should be written and the output file to be used. Your implementation of this method must then render each requested page of content to a multi-page PDF document file.
When this process is complete, you call the onWriteFinished method of the callback object.
How to Print to PDF for Android
Note: The Android print framework may call the onWrite method one or more times for every call to onLayout. For this reason, it is important to set the boolean parameter of onLayoutFinished method to false when the print content layout has not changed, to avoid unnecessary re-writes of the print document.
Setting this parameter properly allows the print framework to avoid unnecessarily calling the onLayout method, essentially caching the previously written print document and improving performance. The following sample demonstrates the basic mechanics of this process using the PrintedPdfDocument class to create a PDF file:.
This sample delegates rendering of PDF page content to drawPage method, which is discussed in the next section. As with layout, execution of onWrite method can have three outcomes: completion, cancellation, or failure in the case where the the content cannot be written. WriteResultCallback object. Note: Rendering a document for printing can be a resource-intensive operation.
In order to avoid blocking the main user interface thread of your application, you should consider performing the page rendering and writing operations on a separate thread, for example in an AsyncTask. For more information about working with execution threads like asynchronous tasks, see Processes and Threads. When your application prints, your application must generate a PDF document and pass it to the Android print framework for printing.
You can use any PDF generation library for this purpose. You can draw elements on the printed page using the Canvas draw methods.
The following example code demonstrates how to draw some simple elements on a PDF document page using these methods:. Make sure you use this unit of measure for specifying the size of elements on the page. For positioning of drawn elements, the coordinate system starts at 0,0 for the top left corner of the page.
Tip: While the Canvas object allows you to place print elements on the edge of a PDF document, many printers are not able to print to the edge of a physical piece of paper.
Make sure that you account for the unprintable edges of the page when you build a print document with this class. Content and code samples on this page are subject to the licenses described in the Content License.
Steps for Printing to PDF on Android Devices
Build your first app. App resources.
Xamarin Android Tutorial - Create PDF File and Print
Resource types. App manifest file.
Create a print adapter
App permissions. Device compatibility. Multiple APK support. Adding wearable features to notifications. Creating wearable apps. Creating custom UIs. Sending and syncing data. Creating data providers.
Printing from a Xamarin.Android Application Developed with Visual Studio
Creating watch faces. Android TV. Build TV Apps. Build TV playback apps. Help users find content on TV. Recommend TV content. Watch Next. Build TV input services. Android for Cars. Build media apps for cars. Android Things. Developer kits. Advanced setup.
Print PDF file
Build apps. Create a Things app. Communicate with wireless devices. Configure devices. Interact with peripherals. Build user-space drivers. Manage devices. Create a build. Push an update. Chrome OS devices. Core topics. Interact with other apps.
Handling app links. App shortcuts.