Maximum content height - iOSにおける描画と印刷のガイド (TP )

UIPrintFormatter

は、図 5-8に示したすべてのプロパティを使用して、印刷ジョブに必要なページ数を計算します。この値は、読み取り専用の

pageCount

プロパティに格納されます。

印刷フォーマッタの使用

UIKitを利用すると、単一の印刷フォーマッタを印刷ジョブに割り当てることができます。これは、プ

レーンテキストやHTMLドキュメントを持つ場合に役立つ機能です。UIKitには、この種のテキストコンテンツ用の印刷フォーマッタ具象クラスがあるからです。また、このフレームワークは、特定の

UIKitビューのコンテンツをプリンタに合った方法で印刷できるようにする印刷フォーマッタ具象サブ

クラスも実装しています。

UIPrintFormatter

クラスは、システム組み込みの印刷フォーマッタを表す抽象基底クラスです。現

状、iOSには次の印刷フォーマッタが組み込まれています。

●

UIViewPrintFormatter — 複数ページにわたってビューの内容を自動的にレイアウトします。

印刷フォーマッタやページレンダラの利用

ビューの印刷に用いる印刷フォーマッタを取得するには、当該ビューの

viewPrintFormatter

メソッドを使います。

UIKitの組み込みクラスの中には、印刷処理に対応していないものもあります。現在のところ、印

刷用にコンテンツを描画する方法を認識しているのは、

UIWebView

、

UITextView

、

MKMapView

の各ビュークラスだけです。

ビューフォーマッタは、カスタムビューの印刷には使えません。カスタムビューの内容を印刷したい場合は、代わりに

UIPrintPageRenderer

を使ってください。

●

UISimpleTextPrintFormatter — プレインテキストドキュメントを自動的に描画、レイアウト

します。テキストのグローバルプロパティ（フォント、色、配置、改行モードなど）も設定できます。

●

UIMarkupTextPrintFormatter — HTMLドキュメントを自動的に描画、レイアウトします。

注意:

UIPrintFormatter

クラスはサブクラス化を想定していません。独自にレイアウトを施す必要があれば、代わりにページレンダラを記述してください。

以降の説明は単一のフォーマッタ（ページレンダラなし）の使い方に関係していますが、印刷フォーマッタについてのほとんどの情報は、ページレンダラと組み合わせて使われる印刷フォーマッタにも当てはまります。これについては、“1つ以上のフォーマッタをページレンダラと一緒に使用する” （73 ページ）で説明します。

テキストドキュメントや HTML ドキュメントの印刷

多くのアプリケーションには、ユーザが印刷したいと考えるテキストコンテンツが含まれています。

コンテンツがプレーンテキストやHTMLテキストで、表示されているテキストコンテンツの元になっている文字列にアクセスできる場合は、

UISimpleTextPrintFormatter

または

UIMarkupTextPrintFormatter

のインスタンスを使用して、印刷用にテキストをレイアウトして描画できます。単にインスタンスを作成して、元になっている文字列で初期化し、レイアウトプロパティを指定します。次に、作成したこのインスタンスを、共有の

UIPrintInteractionController

インスタンスのインスタンス変数

printFormatter

に割り当てます。

リスト 5-2 に、

UIMarkupTextPrintFormatter

オブジェクトを使用してHTMLドキュメントを印刷する方法を示します。（プリンタが定義する）印刷可能領域の内側に、さらに余白を追加します。印刷可能領域は、

UIPrintInteractionController

オブジェクトの

printPaper

プロパティで調べることができます。指定した幅の余白を追加する、より完全なコード例は、『UIKit Printing with

UIPrintInteractionController and UIViewPrintFormatter

』サンプルコードプロジェクトを参照してください。

印刷フォーマッタやページレンダラの利用

リスト 5-2 HTMLドキュメント（ヘッダ情報なし）の印刷

- (IBAction)printContent:(id)sender {

UIPrintInteractionController *pic = [UIPrintInteractionController sharedPrintController];

pic.delegate = self;

UIPrintInfo *printInfo = [UIPrintInfo printInfo];

printInfo.outputType = UIPrintInfoOutputGeneral;

printInfo.jobName = self.documentName;

pic.printInfo = printInfo;

UIMarkupTextPrintFormatter *htmlFormatter = [[UIMarkupTextPrintFormatter alloc]

initWithMarkupText:self.htmlString];

htmlFormatter.startPage = 0;

htmlFormatter.contentInsets = UIEdgeInsetsMake(72.0, 72.0, 72.0, 72.0); // 1インチの余白

pic.printFormatter = htmlFormatter;

pic.showsPageRange = YES;

void (^completionHandler)(UIPrintInteractionController *, BOOL, NSError *) =

^(UIPrintInteractionController *printController, BOOL completed, NSError

*error) {

if (!completed && error) {

NSLog(@"Printing could not complete because of error: %@", error);

} };

if (UI_USER_INTERFACE_IDIOM() == UIUserInterfaceIdiomPad) { [pic presentFromBarButtonItem:sender animated:YES completionHandler:completionHandler];

} else {

[pic presentAnimated:YES completionHandler:completionHandler];

} }

印刷フォーマッタやページレンダラの利用

印刷ジョブに単一の印刷フォーマッタを使用する場合は（つまり、

1

つの

UIPrintFormatter

オブジェクトを

UIPrintInteractionController

インスタンスの

printFormatter

プロパティに割り当てる）、

印刷される各ページにヘッダとフッタのコンテンツを描画することはできません。ヘッダとフッタを描画するには、

UIPrintPageRenderer

オブジェクトに加えて、必要な印刷フォーマッタを使用する必要があります。詳細については、“1つ以上のフォーマッタをページレンダラと一緒に使用する” （73 ページ）を参照してください。

UISimpleTextPrintFormatter

オブジェクトを使用してプレーンテキストドキュメントをレイアウトして印刷する手順も、ほとんど同じです。ただし、このオブジェクトのクラスには、フォント、色、

印刷するテキストの配置を設定するプロパティが含まれています。

ビュー印刷フォーマッタの使用

UIViewPrintFormatter

クラスのインスタンスを使用して、いくつかのシステムビューのコンテンツをレイアウトして印刷できます。UIKitフレームワークは、そのビューに対してこれらのビュー印刷フォーマッタを作成します。多くの場合、表示用のビューの描画に使われるコードと同じものが、印刷用のビューの描画にも使われます。現時点では、ビュー印刷フォーマッタを使用してコンテンツを印刷できるシステムビューは、

UIWebView

、

UITextView

、および

MKMapView

（MapKitフレームワーク）のインスタンスです。

UIView

オブジェクトのビュー印刷フォーマッタを取得するには、ビューに対して

viewPrintFormatter

を呼び出します。開始ページと任意のレイアウトプロパティを設定して、このオブジェクトを共有インスタンス

UIPrintInteractionController

の

printFormatter

プロパティに割り当てます。あるいは、印刷する出力の一部を

UIPrintPageRenderer

オブジェクトを使用して描画している場合は、このオブジェクトにビュー印刷フォーマッタを追加することもできます。リスト 5-3に、

UIWebView

オブジェクトのビュー印刷フォーマッタを使用して、そのビューのコンテンツを印刷するコードを示します。

リスト 5-3 Web Viewのコンテンツの印刷

- (void)printWebPage:(id)sender {

UIPrintInteractionController *controller = [UIPrintInteractionController sharedPrintController];

void (^completionHandler)(UIPrintInteractionController *, BOOL, NSError *) =

^(UIPrintInteractionController *printController, BOOL completed, NSError

*error) {

if(!completed && error){

NSLog(@"FAILED! due to error in domain %@ with error code %u", error.domain, error.code);

} };

印刷フォーマッタやページレンダラの利用

UIPrintInfo *printInfo = [UIPrintInfo printInfo];

printInfo.outputType = UIPrintInfoOutputGeneral;

printInfo.jobName = [urlField text];

printInfo.duplex = UIPrintInfoDuplexLongEdge;

controller.printInfo = printInfo;

controller.showsPageRange = YES;

UIViewPrintFormatter *viewFormatter = [self.myWebView viewPrintFormatter];

viewFormatter.startPage = 0;

controller.printFormatter = viewFormatter;

if (UI_USER_INTERFACE_IDIOM() == UIUserInterfaceIdiomPad) { [controller presentFromBarButtonItem:printButton animated:YES completionHandler:completionHandler];

}else

[controller presentAnimated:YES completionHandler:completionHandler];

}

UIViewPrintFormatter

を使った完全なコード例は、『UIKit Printing with UIPrintInteractionController

and UIViewPrintFormatter

』サンプルコードプロジェクトを参照してください。

ページレンダラの使い方

ページレンダラは、印刷ジョブの一部または全部を描画する

UIPrintPageRenderer

のカスタムサブクラスのインスタンスです。これを使用するには、印刷ジョブのために

UIPrintInteractionController

インスタンスを準備するときに、サブクラスを作成してプロジェクトに追加し、これをインスタンス化する必要があります。次に、このページレンダラを

UIPrintInteractionController

のインスタンスの

printPageRenderer

プロパティに割り当てます。

1つのページレンダラに、1つまたは複数の印刷フォーマッタを関連付けることができます。その場

合、ページレンダラは、自身の描画と印刷フォーマッタの描画を混合します。

ページレンダラは、印刷可能なコンテンツを自ら描画、レイアウトするほか、印刷フォーマッタを下請けとして使い、指定したページ範囲の一部または全部のレンダリング処理を委ねることも可能です。したがって、ごく簡単な整形だけで構わなければ、

UIPrintPageRenderer

そのもののインスタンスを使い、必要な数の印刷フォーマッタに接続すればよいことになります。しかし通常は、

UIPrintPageRenderer

のカスタムサブクラスのインスタンスとしてページレンダラを実装することが多いでしょう。

印刷フォーマッタやページレンダラの利用

注意

:

ドキュメントタイトルを繰り返し印刷したり、ページ数をインクリメントするなど、

ヘッダ情報やフッタ情報を印刷する場合は、

UIPrintPageRenderer

のカスタムサブクラスを使用する必要があります。

基底クラスである

UIPrintPageRenderer

には、ページ数を表すプロパティと、ページのヘッダとフッタの高さを表すプロパティが含まれています。また、このクラスでは、いくつかのメソッドが宣言されています。これらのメソッドをオーバーライドしてページの特定の部分（ヘッダ、フッタ、コンテンツ自体）を描画したり、ページレンダラと印刷フォーマッタによる描画を組み込むことができます。

ページレンダラ属性の設定

ページレンダラが、印刷する各ページのヘッダとフッタに描画する場合は、ヘッダやフッタの高さを指定する必要があります。それには、浮動小数点値（ポイント数を表す）を、ページレンダラのサブクラスが継承した

headerHeight

プロパティと

footerHeight

プロパティに割り当てます。これらのプロパティの高さの値が0の場合（デフォルト）、

drawHeaderForPageAtIndex:inRect:

メソッドと

drawFooterForPageAtIndex:inRect:

メソッドは呼び出されません。

ページレンダラがページのコンテンツ領域（ヘッダとフッタの間の領域）に描画する場合は、ページレンダラのサブクラスで

numberOfPages

メソッドをオーバーライドして、ページレンダラが描画するページ数を計算して返すようにします。ページレンダラに関連付けられている印刷フォーマッタが、

ヘッダとフッタの間にあるコンテンツをすべて描画する場合は、印刷フォーマッタがページ数を計算してくれます。この状況は、ページレンダラがヘッダやフッタ領域だけを描画し、その他のコンテンツはすべて印刷フォーマッタが描画する場合に生じます。

ページレンダラに印刷フォーマッタが関連付けられていない場合は、印刷可能なコンテンツの各ページのレイアウトはすべてデベロッパに任されます。レイアウトの寸法を計算するときは、

UIPrintPageRenderer

の

headerHeight

、

footerHeight

、

paperRect

、および

printableRect

の各プロパティを考慮します（最後の2つのプロパティは読み取り専用です）。ページレンダラが印刷フォーマッタを使用している場合は、レイアウトの寸法に

contentInsets

の