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

Обзор элемента управления PrintPreviewDialog (Windows Forms)

Элемент управления Windows Forms PrintPreviewDialog — это предварительно настроенное диалоговое окно, используемое для показа, как PrintDocument выглядит при печати. Используйте его в приложении под управлением Windows в качестве простого решения вместо настройки собственного диалогового окна. Элемент управления содержит кнопки для печати, увеличения масштаба, отображения одной или нескольких страниц и закрытия диалогового окна.

Ключевые свойства и методы

Ключевое свойство элемента управления - Document, которое устанавливает документ для предварительного просмотра. Документ должен быть объектом PrintDocument. Чтобы отобразить диалоговое окно, необходимо вызвать его метод ShowDialog. Сглаживание может сделать текст более плавным, но также оно может замедлить визуализацию; чтобы использовать его, задайте для свойства UseAntiAlias значение true.

Определённые свойства доступны через PrintPreviewControl, который содержится в PrintPreviewDialog. (Вам не нужно добавлять PrintPreviewControl в форму; она автоматически включается в PrintPreviewDialog, когда вы добавляете диалоговое окно в форму.) Примеры свойств, доступных через PrintPreviewControl, включают свойства Columns и Rows, которые определяют количество страниц, отображаемых по горизонтали и вертикали в управляемом элементе. Вы можете получить доступ к свойству Columns как PrintPreviewDialog1.PrintPreviewControl.Columns в Visual Basic, printPreviewDialog1.PrintPreviewControl.Columns в Visual C# или printPreviewDialog1->PrintPreviewControl->Columns в Visual C++.

Производительность PrintPreviewDialog

В следующих условиях PrintPreviewDialog элемент управления инициализируется медленно:

  • Используется сетевой принтер.
  • Параметры пользователя для этого принтера, такие как дуплексные параметры, изменяются.

Оптимизация не применяется, если событие QueryPageSettings используется для изменения параметров страницы.

Чтобы применить оптимизацию, задайте для параметра конфигурации среды выполнения Switch.System.Drawing.Printing.OptimizePrintPreview значение true.

Параметр можно задать в файле конфигурацииruntimeconfig.json или файле проекта приложения:

  • Настройте значение по умолчанию в файле проекта.

    Чтобы применить параметр в файле проекта, включите создание конфигурации среды выполнения, установив для этого <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles> в <PropertyGroup>. Затем добавьте параметр <RuntimeHostConfigurationOption> в <ItemGroup>.

    <Project Sdk="Microsoft.NET.Sdk">

  <!-- Other project settings ... -->

  <PropertyGroup>
    <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles>
  </PropertyGroup>

  <ItemGroup>
    <RuntimeHostConfigurationOption Include="Switch.System.Drawing.Printing.OptimizePrintPreview" Value="true" />
  </ItemGroup>

</Project>

  • Настройте значение по умолчанию в исходном файле runtimeconfig.template.json .

    Чтобы настроить параметр по умолчанию для приложения, примените этот параметр в исходном файле runtimeconfig.template.json . При компиляции или публикации приложения файл шаблона используется для создания файла конфигурации среды выполнения.

    {
  "configProperties": {
    "Switch.System.Drawing.Printing.OptimizePrintPreview": true
  }
}

    Дополнительные сведения о конфигурации среды выполнения см. в разделе параметров конфигурации среды выполнения .NET.

  • Настройте опубликованное приложение с выходным файлом {appname}.runtimeconfig.json.

    Чтобы настроить опубликованное приложение, примените параметр в разделе {appname}.runtimeconfig.json файла runtimeOptions/configProperties .

    {
  "runtimeOptions": {
    "configProperties": {
      "Switch.System.Drawing.Printing.OptimizePrintPreview": true,
    }
  }
}

    Дополнительные сведения о конфигурации среды выполнения см. в разделе параметров конфигурации среды выполнения .NET.

См. также

  • Last updated on