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。
傳回
成功時產生的列印工作，失敗時則為空。
- 屬性
例外狀況
如果不是從 Activity.
如果列印工作名稱為空或文件適配器為空。
備註
建立一個帶有預設列印屬性的列印工作。PrintDocumentAdapter
呼叫此方法會顯示列印介面，讓使用者能自訂列印工作，並在不等待使用者自訂或確認列印工作的情況下回傳 PrintJob 物件。 回傳的列印工作實例處於一個 PrintJobInfo#STATE_CREATED created 狀態。
此方法只能從 中 Activity呼叫。 其理由是從服務列印會造成使用者體驗不一致，因為列印介面會毫無上下文。
而且，如果你的活動已經結束，傳入 PrintDocumentAdapter 的會被視為無效。 其理由是，一旦啟動列印的活動結束，所提供的轉接器可能處於不一致狀態，因為它可能依賴於該活動所呈現的使用者介面。
預設的列印屬性是系統如何列印資料的提示。 例如，照片編輯師可能會查看照片的長寬比，以判斷預設的方向，並提供列印應該是直向還是橫向的提示。 系統會盡力在列印對話框中選擇提示選項，前提是目前印表機支援這些選項。
<strong>Note：</strong> 呼叫此方法會產生列印對話框，系統也會連接到所提供的 PrintDocumentAdapter。 若發生應用程式無法處理的設定變更，例如旋轉變更，系統會中斷與介面卡的連線，因為該活動必須重新建立，舊介面卡在此情境下可能無效，因此需要新的介面卡實例。 因此，如果你的活動無法處理設定變更（預設行為），你必須儲存你正在列印的狀態，並在重新建立活動時再呼叫這個方法。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。