通过

从 WebView2 应用打印

  • 项目

有几种不同的方法可以在 WebView2 中打印网页，这为你提供了各种级别的实现和自定义便利。

方法 说明
ShowPrintUI 打开“WebView2 打印预览 ”对话框或操作系统的“ 打印 ”对话框。 易于实现，对自定义的支持最少。
Print 使用可选的以编程方式指定的打印设置将 WebView2 中的当前顶级文档打印到打印机。 可以使用此功能生成自己的“打印预览”对话框或打印体验。
PrintToPdf 以无提示方式将 WebView2 中的当前顶级文档打印为 PDF 文件。 可以使用它生成自己的代码来打印 PDF 文件。
PrintToPdfStream 以无提示方式将 WebView2 中的当前顶级文档打印到 PDF 流。 可以使用它来生成自己的代码来打印 PDF。

用于打开“打印”对话框的 ShowPrintUI 方法

方法 ShowPrintUI 打开 WebView2 控件中当前顶级文档的“WebView2 打印预览 ”对话框或操作系统的“ 打印 ”对话框。 使用此方法，可以轻松为用户提供熟悉的打印体验。

示例：用于打开“打印”对话框的 ShowPrintUI 方法

此示例向用户显示 “打印 ”对话框。

  • 如果 printDialog 为 CoreWebView2PrintDialogKind.Browser，则打开浏览器的“打印预览”对话框。
  • 如果 printDialog 为 CoreWebView2PrintDialogKind.System，则打开系统“打印”对话框。
void ShowPrintUI(object target, ExecutedRoutedEventArgs e)
{
  string printDialog = e.Parameter.ToString();
  if (printDialog == "Browser")
  {
    // Opens the browser's Print Preview dialog.
    webView.CoreWebView2.ShowPrintUI();
  }
  else
  {
    // Opens a system's Print dialog.
    webView.CoreWebView2.ShowPrintUI(CoreWebView2PrintDialogKind.System);
  }
}

用于自定义打印的 Print 方法

方法 Print 使用可选的、以编程方式指定的打印设置，以静默方式打印 WebView2 控件中的当前顶级文档。 如果要生成自己的“打印预览”对话框或构建自己的打印体验，可以使用此方法。 此 API 由异步 Print 方法和 PrintSettings 对象组成。

示例 1：使用默认打印设置的不带对话框的 Print 方法

本示例使用默认打印设置将当前网页打印到默认打印机，而无需打开 “打印 ”对话框。

async void PrintToDefaultPrinter ()
{
  string title = webView.CoreWebView2.DocumentTitle;
  try
  {
    // Prints the current webpage, using the default printer and page settings.
    // Passing null for PrintSettings causes the default print settings to be used.
    CoreWebView2PrintStatus printStatus = await webView.CoreWebView2.PrintAsync(null);

    if (printStatus == CoreWebView2PrintStatus.Succeeded)
    {
      MessageBox.Show(this, "Printing " + title + " document to printer succeeded", "Print to default printer");
    }
    else if (printStatus == CoreWebView2PrintStatus.PrinterUnavailable)
    {
      MessageBox.Show(this, "Printer is not available, offline or error state", "Print to default printer");
    }
    else
    {
      MessageBox.Show(this, "Printing " + title + " document to printer is failed", "Print to default printer");
    }
  }
  catch (Exception)
  {
    MessageBox.Show(this, "Printing " + title + " document already in progress", "Print to default printer");
  }
}

示例 2：使用自定义打印设置打印到指定打印机的 Print 方法

本示例使用指定的设置将当前网页打印到特定打印机。

async void PrintToPrinter()
{
  string printerName = GetPrinterName();
  CoreWebView2PrintSettings printSettings = GetSelectedPrinterPrintSettings(printerName);
  string title = webView.CoreWebView2.DocumentTitle;
  try
  {
    CoreWebView2PrintStatus printStatus = await webView.CoreWebView2.PrintAsync(printSettings);

    if (printStatus == CoreWebView2PrintStatus.Succeeded)
    {
      MessageBox.Show(this, "Printing " + title + " document to printer succeeded", "Print to printer");
    }
    else if (printStatus == CoreWebView2PrintStatus.PrinterUnavailable)
    {
      MessageBox.Show(this, "Selected printer is not found, not available, offline or error state", "Print to printer");
    }
    else
    {
      MessageBox.Show(this, "Printing " + title + " document to printer is failed", "Print");
    }
  }
  catch(ArgumentException)
  {
    MessageBox.Show(this, "Invalid settings provided for the specified printer", "Print");
  }
  catch (Exception)
  {
    MessageBox.Show(this, "Printing " + title + " document already in progress", "Print");
  }
}

// Gets the printer name by displaying the list of installed printers to the user and
// returns the name of the user's selected printer.
string GetPrinterName()
{
  // Use GetPrintQueues() of LocalPrintServer from System.Printing to get the list of locally installed printers.
  // Display the list of printers to the user and get the desired printer to use.
  // Return the name of the selected printer.
}

// Gets the print settings for the selected printer.
// You can also get the capabilities from the native printer API, and display them 
// to the user to get the print settings for the current webpage and for the selected printer.
CoreWebView2PrintSettings GetSelectedPrinterPrintSettings(string printerName)
{
  CoreWebView2PrintSettings printSettings = null;
  printSettings = WebViewEnvironment.CreatePrintSettings();
  printSettings.ShouldPrintBackgrounds = true;
  printSettings.ShouldPrintHeaderAndFooter = true;

  return printSettings;

  // or
  // Get PrintQueue for the selected printer and use GetPrintCapabilities() of PrintQueue from System.Printing
  // to get the capabilities of the selected printer.
  // Display the printer capabilities to the user along with the page settings.
  // Return the user selected settings.
}

使用自定义打印设置打印到 PDF 文件的 PrintToPdf 方法

以无提示方式将 WebView2 控件中的当前顶级文档打印到 PDF 文件。 若要完全控制打印的执行方式，可以打印到 PDF，然后生成自己的代码来打印 PDF。

此 API 由异步 PrintToPdf 方法和 PrintSettings 对象组成。 方法 PrintToPdf 接受 PDF 文件将保存到的路径。

示例：使用自定义打印设置打印到 PDF 文件的 PrintToPdf 方法

本示例使用默认路径和设置将当前网页打印为 PDF 文件。

async void PrintToPdfCmdExecuted(object target, ExecutedRoutedEventArgs e)
{
    if (_isPrintToPdfInProgress)
    {
        MessageBox.Show(this, "Print to PDF in progress", "Print To PDF");
        return;
    }
    CoreWebView2PrintSettings printSettings = null;
    string orientationString = e.Parameter.ToString();
    if (orientationString == "Landscape")
    {
        printSettings = WebViewEnvironment.CreatePrintSettings();
        printSettings.Orientation =
            CoreWebView2PrintOrientation.Landscape;
    }

    Microsoft.Win32.SaveFileDialog saveFileDialog =
        new Microsoft.Win32.SaveFileDialog();
    saveFileDialog.InitialDirectory = "C:\\";
    saveFileDialog.Filter = "PDF Files|*.pdf";
    Nullable<bool> result = saveFileDialog.ShowDialog();
    if (result == true) {
        _isPrintToPdfInProgress = true;
        bool isSuccessful = await webView.CoreWebView2.PrintToPdfAsync(
            saveFileDialog.FileName, printSettings);
        _isPrintToPdfInProgress = false;
        string message = (isSuccessful) ?
            "Print to PDF succeeded" : "Print to PDF failed";
        MessageBox.Show(this, message, "Print To PDF Completed");
    }
}

使用自定义打印设置打印到 PDF 流的 PrintToPdfStream 方法

以无提示方式将 WebView2 控件中的当前顶级文档打印到 PDF 流。 若要完全控制打印的执行方式，可以打印到 PDF，然后生成自己的代码来打印 PDF。 此 API 由异步 PrintToPdfStream 方法和 PrintSettings 对象组成。

示例：使用自定义打印设置打印到 PDF 流的 PrintToPdfStream 方法

本示例将当前网页的 PDF 数据打印到流中。

async void PrintToPdfStream()
{
  try
  {
    string title = webView.CoreWebView2.DocumentTitle;

    // Passing null for PrintSettings causes the default print settings to be used.
    System.IO.Stream stream = await webView.CoreWebView2.PrintToPdfStreamAsync(null);
    DisplayPdfDataInPrintDialog(stream);

    MessageBox.Show(this, "Printing " + title + " document to PDF Stream " +
                ((stream != null) ? "succeeded" : "failed"), "Print To PDF Stream");
  }
  catch(Exception exception)
  {
    MessageBox.Show(this, "Printing to PDF Stream failed: " + exception.Message, "Print to PDF Stream");
  }
}

// Function to display current webpage PDF data in a custom Print Preview dialog.
void DisplayPdfDataInPrintDialog(Stream pdfData)
{
  // You can display the printable PDF data to the user in a custom Print Preview dialog.
}

另请参阅