PrintDocumentAdapter クラス

リファレンス

定義

名前空間:: Android.Print

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

印刷するドキュメントの内容を提供する基本クラス。

[Android.Runtime.Register("android/print/PrintDocumentAdapter", DoNotGenerateAcw=true)]
public abstract class PrintDocumentAdapter : Java.Lang.Object

[<Android.Runtime.Register("android/print/PrintDocumentAdapter", DoNotGenerateAcw=true)>]
type PrintDocumentAdapter = class
    inherit Object

継承: Object

Object
PrintDocumentAdapter

属性: RegisterAttribute

注釈

印刷するドキュメントの内容を提供する基本クラス。

<h3>ライフサイクル</h3>

<ul><li> 最初に、次の呼び出し #onStart()を受け取ります。このコールバックは、リソースの割り当てに使用できます。 </li li><> 次に、印刷属性 (ページサイズ、密度など) が変更されたことを通知する #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) 1 つ以上の呼び出しを受け取り、新しい制約に合わせてコンテンツをレイアウトできます。 </li li><> 呼び出し#onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle)のたびに、特定<のページの内容を含む PDF ファイルを書き込むよう求める強い>>呼び出し#onWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, WriteResultCallback)を<受けます。 </li li><> 最後に、次の呼び出し#onFinish()を受け取ります。このコールバックを使用して、割り当てられた #onStart()リソースを解放できます。 </li></ul>

コールバックは #onStart() 常に最初に受け取る呼び出しであり、印刷前に 1 回のセットアップまたはリソース割り当てを行う場合に便利です。この場合、後続の呼び出しは受け取りません。

コールバックでは #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) 、現在 PrintAttributesの内容に基づいてコンテンツをレイアウトする必要があります。渡されたコールバックインスタンスでいずれかのメソッドを呼び出すまで、このメソッドの実行は完了したとは見なされません。そのため、コールバックメソッドの 1 つを呼び出してこのメソッドの実行が完了するまで、このクラスの他のメソッドの後続の呼び出しを受け取りません。

指定 #onWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, WriteResultCallback) した宛先に一部のページのコンテンツをレンダリングして書き込む必要があります。渡されたコールバックインスタンスでいずれかのメソッドを呼び出すまで、このメソッドの実行は完了とは見なされません。そのため、コールバックメソッドの 1 つを呼び出してこのメソッドの実行が完了するまで、このクラスの他のメソッドの後続の呼び出しを受け取りません。前の呼び出しなしで、このメソッドの 1 つ以上の呼び出しのシーケンスを #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle)受け取ることはありません。

コールバックは #onFinish() 常に最後に受信する呼び出しであり、印刷後に 1 回のクリーンアップまたはリソースの割り当て解除を行う場合に便利です。この場合、後続の呼び出しは受け取りません。

</p><h3>実装</h3>

このクラスで定義されている API は、任意のスレッドで一部またはすべての作業を実行できるように設計されています。たとえば、印刷されたコンテンツが UI の状態 (つまり画面に表示される内容) に依存しない場合は、専用スレッドで作業全体をオフロードし、印刷作業の実行中にアプリケーションを対話形式にすることができます。アクティビティはシステム印刷 UI によってカバーされ、ユーザーは操作できませんが、メインアプリケーションスレッドで印刷作業を行うと、そのスレッドでも実行されるため、他のアプリケーションコンポーネントのパフォーマンスに影響する可能性があることに注意してください。

また、UI コンテンツ#onStart()#onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle)を印刷する場合など、さまざまなスレッドで作業を行うこともできます(レイアウトに必要なリソースを onStart が初期化すると仮定します)。これにより、印刷されたコンテンツのレイアウト中に UI が変更されないようにします。その後、別のスレッドで処理#onWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, WriteResultCallback)#onFinish()できます。これにより、メインスレッドが最小限の時間ビジー状態になります。また、これは必須ではない印刷コンテンツ #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) を生成することを前提としています。複数のスレッドを使用する場合は、適切な同期を行う必要があります。

の Java ドキュメントandroid.print.PrintDocumentAdapter

このページの一部は、Android オープンソースプロジェクトによって作成および共有され、クリエイティブコモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。

コンストラクター

PrintDocumentAdapter()
PrintDocumentAdapter(IntPtr, JniHandleOwnership)	JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。

フィールド

ExtraPrintPreview

Extra: 現在のレイアウトが印刷プレビューfalse用の場合はtrueブール値にマップされます。それ以外の場合。

プロパティ

Class	この `Object`ランタイムクラスを返します。 (継承元 Object)
Handle	基になる Android インスタンスへのハンドル。 (継承元 Object)
JniIdentityHashCode	印刷するドキュメントの内容を提供する基本クラス。 (継承元 Object)
JniPeerMembers	印刷するドキュメントの内容を提供する基本クラス。
PeerReference	印刷するドキュメントの内容を提供する基本クラス。 (継承元 Object)
ThresholdClass	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。
ThresholdType	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。

メソッド

Clone()	このオブジェクトのコピーを作成して返します。 (継承元 Object)
Dispose()	印刷するドキュメントの内容を提供する基本クラス。 (継承元 Object)
Dispose(Boolean)	印刷するドキュメントの内容を提供する基本クラス。 (継承元 Object)
Equals(Object)	他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object)
GetHashCode()	オブジェクトのハッシュコード値を返します。 (継承元 Object)
JavaFinalize()	オブジェクトへの参照がなくなったとガベージコレクションによって判断されたときに、オブジェクトのガベージコレクターによって呼び出されます。 (継承元 Object)
Notify()	このオブジェクトのモニターで待機している 1 つのスレッドを起動します。 (継承元 Object)
NotifyAll()	このオブジェクトのモニターで待機しているすべてのスレッドを起動します。 (継承元 Object)
OnFinish()	印刷が完了したときに呼び出されます。
OnLayout(PrintAttributes, PrintAttributes, CancellationSignal, PrintDocumentAdapter+LayoutResultCallback, Bundle)	印刷属性 (ページサイズ、密度など) が変更されたときに呼び出され、新しい制約に一致するようにコンテンツをレイアウトできます。
OnStart()	印刷開始時に呼び出されます。
OnWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, PrintDocumentAdapter+WriteResultCallback)	コンテンツの特定のページを PDF ファイルの形式で特定のファイル記述子に書き込む必要がある場合に呼び出されます。
SetHandle(IntPtr, JniHandleOwnership)	Handle プロパティを設定します。 (継承元 Object)
ToArray<T>()	印刷するドキュメントの内容を提供する基本クラス。 (継承元 Object)
ToString()	オブジェクトの文字列表現を返します。 (継承元 Object)
UnregisterFromRuntime()	印刷するドキュメントの内容を提供する基本クラス。 (継承元 Object)
Wait()	現在のスレッドが目覚めるまで待機させます。通常<は、通知<>/em> または <em>割り込み/em> を受け<取ります。 (継承元 Object)
Wait(Int64)	現在のスレッドが目覚めるまで待機します。通常<><は、通知/em> または <em>中断</em> によって、または一定のリアルタイムが経過するまで待機します。 (継承元 Object)
Wait(Int64, Int32)	現在のスレッドが目覚めるまで待機します。通常<><は、通知/em> または <em>中断</em> によって、または一定のリアルタイムが経過するまで待機します。 (継承元 Object)

明示的なインターフェイスの実装

IJavaPeerable.Disposed()	印刷するドキュメントの内容を提供する基本クラス。 (継承元 Object)
IJavaPeerable.DisposeUnlessReferenced()	印刷するドキュメントの内容を提供する基本クラス。 (継承元 Object)
IJavaPeerable.Finalized()	印刷するドキュメントの内容を提供する基本クラス。 (継承元 Object)
IJavaPeerable.JniManagedPeerState	印刷するドキュメントの内容を提供する基本クラス。 (継承元 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	印刷するドキュメントの内容を提供する基本クラス。 (継承元 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	印刷するドキュメントの内容を提供する基本クラス。 (継承元 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	印刷するドキュメントの内容を提供する基本クラス。 (継承元 Object)

拡張メソッド

JavaCast<TResult>(IJavaObject)	Android ランタイムチェック型変換を実行します。
JavaCast<TResult>(IJavaObject)	印刷するドキュメントの内容を提供する基本クラス。
GetJniTypeName(IJavaPeerable)	印刷するドキュメントの内容を提供する基本クラス。

適用対象

次の方法で共有