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>Lifecycle</h3>

<ul><li> 最初に、 #onStart()の呼び出しを受け取ります。このコールバックは、リソースの割り当てに使用できます。 </li><li> 次に、 #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) の呼び出しを 1 つ以上受け取り、印刷属性 (ページサイズ、密度など) が変更されたことを通知し、新しい制約に合わせてコンテンツをレイアウトできます。 </li><li>#onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle) を呼び出すたびに、 <strong>may</strong> 特定のページの内容を含む 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 つを呼び出してこのメソッドの実行が完了するまで、このクラスの他のメソッドの後続の呼び出しを受け取りません。 #onLayout(PrintAttributes, PrintAttributes, CancellationSignal, LayoutResultCallback, Bundle)の前の呼び出しなしで、このメソッドの 1 つ以上の呼び出しのシーケンスを受け取ることはありません。

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

</p><h3>Implementation</h3>

このクラスで定義されている API は、任意のスレッドで一部またはすべての作業を実行できるように設計されています。たとえば、印刷されたコンテンツが UI の状態 (つまり画面に表示される内容) に依存しない場合は、専用スレッドで作業全体をオフロードし、印刷作業の実行中にアプリケーションを対話形式にすることができます。アクティビティはシステム印刷 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ドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

コンストラクター

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

フィールド

名前	説明
ExtraPrintPreview	Extra: 現在のレイアウトが印刷プレビュー用の場合に `true` されるブール値にマップ `false` それ以外の場合。

プロパティ

名前	説明
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>notified</em> または <em>interrupted</em>。 (継承元 Object)
Wait(Int64, Int32)	現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object)
Wait(Int64)	現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</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)

拡張メソッド

名前	説明
GetJniTypeName(IJavaPeerable)	インスタンス `self`の型の JNI 名を取得します。
JavaAs<TResult>(IJavaPeerable)	`self`を強制的に`TResult`入力し、強制型がJava側で有効であることを確認します。
JavaCast<TResult>(IJavaObject)	Android ランタイムチェック型変換を実行します。
JavaCast<TResult>(IJavaObject)	印刷するドキュメントの内容を提供する基本クラス。
TryJavaCast<TResult>(IJavaPeerable, TResult)	`self`を強制的に`TResult`入力し、強制型がJava側で有効であることを確認します。

適用対象