PrintManager.Print(String, PrintDocumentAdapter, PrintAttributes) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
既定の印刷属性を持つ PrintDocumentAdapter を印刷するための印刷ジョブを作成します。
[Android.Runtime.Register("print", "(Ljava/lang/String;Landroid/print/PrintDocumentAdapter;Landroid/print/PrintAttributes;)Landroid/print/PrintJob;", "")]
public Android.Print.PrintJob Print(string printJobName, Android.Print.PrintDocumentAdapter documentAdapter, Android.Print.PrintAttributes? attributes);[<Android.Runtime.Register("print", "(Ljava/lang/String;Landroid/print/PrintDocumentAdapter;Landroid/print/PrintAttributes;)Landroid/print/PrintJob;", "")>]
member this.Print : string * Android.Print.PrintDocumentAdapter * Android.Print.PrintAttributes -> Android.Print.PrintJobパラメーター
- printJobName
- String
ユーザーに表示される新しい印刷ジョブの名前。
- documentAdapter
- PrintDocumentAdapter
印刷するドキュメントを出力するアダプター。
- attributes
- PrintAttributes
既定の印刷ジョブ属性または null。
返品
成功した場合は作成された印刷ジョブ、失敗した場合は null。
- 属性
例外
Activityから呼び出されない場合。
印刷ジョブ名が空であるか、ドキュメント アダプターが null の場合。
注釈
既定の印刷属性を持つ PrintDocumentAdapter を印刷するための印刷ジョブを作成します。
このメソッドを呼び出すと、ユーザーが印刷ジョブをカスタマイズできる印刷 UI が提供され、ユーザーが印刷ジョブをカスタマイズまたは確認するのを待たずに PrintJob オブジェクトが返されます。 返された印刷ジョブ インスタンスが PrintJobInfo#STATE_CREATED created 状態です。
このメソッドは、 Activityからのみ呼び出すことができます。 その理由は、サービスからの印刷では、印刷 UI がコンテキストなしで表示されるため、一貫性のないユーザー エクスペリエンスが作成されるということです。
また、アクティビティが完了すると、渡された PrintDocumentAdapter は無効と見なされます。 その理由は、印刷を開始したアクティビティが終了すると、提供されたアダプターがアクティビティによって提示される UI に依存する可能性があるため、一貫性のない状態になる可能性があるということです。
既定の印刷属性は、データの印刷方法をシステムに示すヒントです。 たとえば、フォト エディターでは、写真の縦横比を調べて既定の向きを決定し、印刷を縦または横にするかどうかを示すヒントを提供できます。 現在のプリンターでサポートされている場合、システムは印刷ダイアログでヒント付きオプションを選択するよう最善を尽くします。
<strong>Note:</strong> このメソッドを呼び出すと、印刷ダイアログが表示され、システムは指定された PrintDocumentAdapterに接続します。 アプリケーションが処理しない構成変更 (たとえば、ローテーションの変更) が発生した場合、アクティビティを再作成する必要があるため、システムはアダプターへの接続を削除します。このコンテキストでは古いアダプターが無効である可能性があるため、新しいアダプター インスタンスが必要です。 その結果、アクティビティが構成の変更 (既定の動作) を処理しない場合は、印刷していた状態を保存し、アクティビティが再作成されたときにこのメソッドを再度呼び出す必要があります。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。