PrintManager.ShowPrintUIAsync Метод

Определение

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

Windows.Graphics.Printing

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

public:
 static IAsyncOperation<bool> ^ ShowPrintUIAsync();

/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<bool> ShowPrintUIAsync();

[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<bool> ShowPrintUIAsync();

function showPrintUIAsync()

Public Shared Function ShowPrintUIAsync () As IAsyncOperation(Of Boolean)

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

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Логическое значение, указывающее значение TRUE для успешного выполнения или FALSE для сбоя.

Атрибуты

RemoteAsyncAttribute

Комментарии

Этот метод может использоваться приложением, которое уже использовало GetForCurrentView для получения экземпляра PrintManager и зарегистрировало прослушиватель для события PrintTaskRequested для запуска пользовательского интерфейса печати. ShowPrintUIAsync отображает соответствующее окно печати. Если печать не может быть выполнена в это время, метод вызовет исключение. Мы рекомендуем перехватывать эти исключения и уведомлять пользователя, когда печать не может быть продолжена, как показано ниже.

async private void printButton_Click(object sender, RoutedEventArgs e)
{
    try
    {
        // Show print UI
        await Windows.Graphics.Printing.PrintManager.ShowPrintUIAsync();

    }
    catch
    {
        // Printing cannot proceed at this time
        ContentDialog noPrintingDialog = new ContentDialog()
        {
            Title = "Printing error",
            Content = "\nSorry, printing can't proceed at this time.", PrimaryButtonText = "OK"
        };
        await noPrintingDialog.ShowAsync();
    }
}

В этом примере окно печати отображается в обработчике событий для нажатия кнопки. Если метод вызывает исключение (поскольку выполнение печати в это время невозможно), то элемент управления ContentDialog информирует пользователя о ситуации. Дополнительные сведения о печати из приложения см. в разделе Печать.

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

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