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 控件将通知用户该情况。 有关从应用打印的详细信息，请参阅 打印。

另请参阅

• 打印