PrintTaskRequest Класс

Определение

public ref class PrintTaskRequest sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class PrintTaskRequest final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class PrintTaskRequest

Public NotInheritable Class PrintTaskRequest

Наследование

Object Platform::Object IInspectable PrintTaskRequest

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute

Требования к Windows

Комментарии

Класс PrintTaskRequest используется приложением для создания нового объекта PrintTask . Объект PrintTask создается в ответ на событие PrintTaskRequested и указывает системе, что приложение содержит содержимое для печати. При создании объекта PrintTask с помощью метода CreatePrintTask приложение должно предоставить имя для PrintTask и обработчик событий PrintTaskSourceRequestedHandler , который вызывается при необходимости печати содержимого.

Приложение должно выполнять минимальный объем работы, возможный в обработчике событий PrintTaskRequested , так как для ответа предоставляется только небольшое время. Везде, где это возможно, приложение должно просто создать PrintTask и отложить инициализацию содержимого до вызова обработчика событий PrintTaskSourceRequestedHandler .

Если приложению необходимо выполнить асинхронную операцию во время обработчика PrintTaskRequested , оно должно получить и использовать объект PrintTaskRequestedDeferral . Перед выходом обработчика событий и, как правило, перед запуском асинхронной операции приложение должно получить объект PrintTaskRequestedDeferral , вызвав метод GetDeferral объекта PrintTaskRequest. После завершения асинхронной операции приложение должно вызвать метод Complete объекта PrintTaskRequestedDeferral , чтобы сообщить о завершении запроса задачи печати. Вызов метода Complete должен произойти до достижения крайнего срока , чтобы запрос был принят.

Для создания задачи печати можно использовать метод CreatePrintTaskTaskв PrintTaskRequest . Ниже приведен фрагмент кода из примера печати UWP , в который показано создание задачи печати:

protected virtual void PrintTaskRequested(PrintManager sender, PrintTaskRequestedEventArgs e)
{
    PrintTask printTask = null;
    printTask = e.Request.CreatePrintTask("C# Printing SDK Sample", sourceRequested =>
    {
        // Print Task event handler is invoked when the print job is completed.
        printTask.Completed += async (s, args) =>
        {
            // Notify the user when the print operation fails.
            if (args.Completion == PrintTaskCompletion.Failed)
            {
                await scenarioPage.Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, () =>
                {
                    MainPage.Current.NotifyUser("Failed to print.", NotifyType.ErrorMessage);
                });
            }
        };

        sourceRequested.SetSource(printDocumentSource);
    });
}

Дополнительные сведения об этом и других сценариях печати см. в разделе Печать и пример печати UWP.

Свойства

Методы

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

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

• Вывод на печать