UIPrintFormatter is an abstract base class for print formatters: objects that lay out custom printable content that can cross page boundaries. Given a print formatter, the printing system can automate the printing of the type of content associated with the print formatter.
- iOS 4.2+
Examples of such content could be a web view, a mix of images and text, or a long text document. The UIKit framework provides several concrete subclasses of
You can assign a single print formatter for a print job via the
printFormatter property of the
UIPrintInteractionController shared instance; or you can specify one or more print formatters that are associated with specific pages of a page renderer through the
UIPrintPageRenderer. A page renderer is an instance of a custom subclass of
UIPrintPageRenderer that draws content for printing.
UIPrintFormatter publishes an interface that allows you to specify the starting page for a print job and the margins around the printed content; given that information plus the content, a print formatter computes the number of pages for the print job. Figure 1 depicts the print-formatter properties, along with certain
UIPrintPageRenderer properties, that define the layout of a multi-page print job.
Third-party subclasses of
UIPrintFormatter are not recommended. If you have custom content to print, use a custom