PrintManager.Print(String, PrintDocumentAdapter, PrintAttributes) Метод

Ссылка

Определение

Пространство имен:: Android.Print

Сборка:: Mono.Android.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Создает задание печати для печати 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.

Возвращаемое значение

PrintJob

Созданное задание печати при успешном выполнении или значение NULL при сбое.

Атрибуты: RegisterAttribute

Исключения

IllegalStateException

Если не вызывается из .Activity

IllegalArgumentException

Если имя задания печати пусто или адаптер документа имеет значение NULL.

При вызове этого метода пользовательский интерфейс печати позволяет пользователю настраивать задание печати и возвращает PrintJob объект, не дожидаясь настройки или подтверждения задания печати. Возвращенный экземпляр задания печати находится в PrintJobInfo#STATE_CREATED created состоянии .

Этот метод может вызываться только из Activity. Причина заключается в том, что печать из службы создаст несогласованный пользовательский интерфейс, так как пользовательский интерфейс печати будет отображаться без какого-либо контекста.

Кроме того, переданный элемент PrintDocumentAdapter будет считаться недействительным, если ваше действие будет завершено. Обоснование заключается в том, что после завершения действия, которое инициировало печать, предоставленный адаптер может находиться в несогласованном состоянии, так как это может зависеть от пользовательского интерфейса, представленного действием.

Атрибуты печати по умолчанию являются подсказкой системе о том, как должны быть напечатаны данные. Например, редактор фотографий может взглянуть на пропорции фотографии, чтобы определить ориентацию по умолчанию и указать, должна ли печать быть книжной или альбомной. Система сделает все возможное, чтобы выбрать указанные параметры в диалоговом окне печати, учитывая, что текущий принтер поддерживает их.

<strong>Примечание.</strong> При вызове этого метода откроется диалоговое окно печати, и система подключится к предоставленному PrintDocumentAdapter. Если происходит изменение конфигурации, которое приложение не обрабатывает, например изменение поворота, система отключит подключение к адаптеру, так как действие необходимо воссоздать, и старый адаптер может быть недопустимым в этом контексте, поэтому требуется новый экземпляр адаптера. Как следствие, если действие не обрабатывает изменения конфигурации (поведение по умолчанию), необходимо сохранить состояние печати и снова вызвать этот метод при повторном создании действия.

Документация по Java для android.print.PrintManager.print(java.lang.String, android.print.PrintDocumentAdapter, android.print.PrintAttributes).

Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License Creative Commons 2.5 Attribution License.

Применяется к

См. также раздел

PrintJob