다음을 통해 공유

PrintPreviewDialog 컨트롤 개요(Windows Forms)

Windows Forms PrintPreviewDialog 컨트롤은 인쇄할 때 PrintDocument 가 표시되는 방식을 표시하는 데 사용되는 미리 구성된 대화 상자입니다. 고유한 대화 상자를 구성하는 대신 Windows 기반 애플리케이션 내에서 간단한 솔루션으로 사용합니다. 컨트롤에는 인쇄, 확대, 한 페이지 또는 여러 페이지 표시 및 대화 상자 닫기 단추가 포함되어 있습니다.

키 속성 및 메서드

컨트롤의 키 속성은 문서를 미리 볼 수 있도록 설정하는 Document입니다. 문서는 PrintDocument 개체여야 합니다. 대화 상자를 표시하려면 해당 ShowDialog 메서드를 호출해야 합니다. 앤티앨리어싱은 텍스트를 더 부드럽게 표시할 수 있지만 표시 속도가 느려질 수도 있습니다. 이 속성을 사용하려면 UseAntiAlias 속성을 true로 설정합니다.

특정 속성은 PrintPreviewDialog에 포함된 PrintPreviewControl을 통해 사용할 수 있습니다. 폼에 PrintPreviewControl를 추가할 필요가 없습니다. 이는 폼에 대화 상자를 추가할 때 자동으로 PrintPreviewDialog에 포함됩니다. 사용 가능한 PrintPreviewControl 속성의 예로는 컨트롤에서 가로로 표시되는 페이지 수를 결정하는 Columns 속성과 세로로 표시되는 페이지 수를 결정하는 Rows 속성이 있습니다. Visual Basic의 PrintPreviewDialog1.PrintPreviewControl.Columns, Visual C#의 printPreviewDialog1.PrintPreviewControl.Columns 또는 Visual C++의 printPreviewDialog1->PrintPreviewControl->Columns과 같이 Columns 속성에 액세스할 수 있습니다.

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 런타임 구성 설정을 참조하세요.

참고하십시오