Поделиться через


PrintManager.ShowPrintUIAsync Метод

Определение

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

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)

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

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

Атрибуты

Комментарии

Этот метод может использоваться приложением, которое уже использовало 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 информирует пользователя о ситуации. Дополнительные сведения о печати из приложения см. в разделе Печать.

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

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