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
に接続します。 ローテーションの変更など、アプリケーションが処理しない構成変更が発生した場合、アクティビティを再作成する必要があるため、システムはアダプターへの接続を削除します。このコンテキストでは古いアダプターが無効である可能性があるため、新しいアダプター インスタンスが必要です。 その結果、アクティビティで構成の変更 (既定の動作) が処理されない場合は、印刷していた状態を保存し、アクティビティが再作成されたときにこのメソッドを再度呼び出す必要があります。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。