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 합니다. 반환된 인쇄 작업 instance 상태에 있습니다PrintJobInfo#STATE_CREATED created.
이 메서드는 에서 Activity만 호출할 수 있습니다. 근거는 인쇄 UI가 컨텍스트 없이 표시되므로 서비스에서 인쇄하면 일관되지 않은 사용자 환경을 만들 수 있다는 것입니다.
또한 작업이 완료되면 전달된 PrintDocumentAdapter 가 잘못된 것으로 간주됩니다. 근거는 인쇄를 시작한 작업이 완료되면 제공된 어댑터가 활동에서 제공하는 UI에 따라 달라질 수 있으므로 일관되지 않은 상태일 수 있다는 것입니다.
기본 인쇄 특성은 데이터를 인쇄하는 방법에 대한 힌트입니다. 예를 들어 사진 편집기에서는 사진 가로 세로 비율을 확인하여 기본 방향을 결정하고 인쇄가 세로 또는 가로에 있어야 하는지에 대한 힌트를 제공할 수 있습니다. 시스템은 현재 프린터가 지원하는 경우 인쇄 대화 상자에서 힌트 옵션을 선택하기 위해 최선을 다할 것입니다.
<strong>Note:</strong> 이 메서드를 호출하면 인쇄 대화 상자가 표시되고 시스템이 제공된 PrintDocumentAdapter에 연결됩니다. 애플리케이션에서 처리하지 않는 구성 변경이 발생하는 경우(예: 회전 변경) 작업을 다시 만들어야 하므로 시스템에서 어댑터에 대한 연결을 삭제하고 이 컨텍스트에서 이전 어댑터가 유효하지 않을 수 있으므로 새 어댑터 instance 필요합니다. 따라서 활동이 구성 변경 내용(기본 동작)을 처리하지 않는 경우 인쇄한 상태를 저장하고 활동을 다시 만들 때 이 메서드를 다시 호출해야 합니다.
이 페이지의 일부는 만들고 공유하며 에 설명된 조건에 따라 사용되는 작업을 기반으로 수정됩니다.