次の方法で共有

PrintPreviewDialog コントロールの概要 (Windows フォーム)

Windows フォーム PrintPreviewDialog コントロールは、印刷時の PrintDocument の表示方法を表示するために使用される構成済みのダイアログ ボックスです。 独自のダイアログ ボックスを構成する代わりに、Windows ベースのアプリケーション内で単純なソリューションとして使用します。 コントロールには、印刷、拡大、1 つまたは複数のページの表示、ダイアログ ボックスの閉じのためのボタンが含まれています。

主要なプロパティとメソッド

コントロールのキー プロパティが Documentされ、プレビューするドキュメントが設定されます。 ドキュメントは PrintDocument オブジェクトである必要があります。 ダイアログ ボックスを表示するには、その ShowDialog メソッドを呼び出す必要があります。 アンチエイリアシングを使用すると、テキストが滑らかに表示されますが、表示速度が低下する可能性もあります。これを使用するには、 UseAntiAlias プロパティを true に設定します。

特定のプロパティは、PrintPreviewControlに含まれるPrintPreviewDialogを通じて使用できます。 (フォームに PrintPreviewControl を追加する必要はありません。ダイアログをフォームに追加すると、 PrintPreviewDialog に自動的に含まれます)。 PrintPreviewControl で使用できるプロパティの例としては、コントロールに水平方向と垂直方向に表示されるページの数を決定する Columns プロパティと Rows プロパティがあります。 Columns プロパティには、Visual Basic のPrintPreviewDialog1.PrintPreviewControl.Columns、Visual C# のprintPreviewDialog1.PrintPreviewControl.Columns、または Visual C++ のprintPreviewDialog1->PrintPreviewControl->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 ランタイムの構成設定」を参照してください。

こちらも参照ください