Sdílet prostřednictvím

Přehled ovládacího prvku PrintPreviewDialog (Windows Forms)

Ovládací prvek Windows Forms PrintPreviewDialog je předkonfigurované dialogové okno, které slouží k zobrazení, jak se při tisku zobrazí PrintDocument . Použijte ji v rámci aplikace založené na Systému Windows jako jednoduché řešení místo konfigurace vlastního dialogového okna. Ovládací prvek obsahuje tlačítka pro tisk, přiblížení, zobrazení jedné nebo více stránek a zavření dialogového okna.

Klíčové vlastnosti a metody

Klíčová vlastnost ovládacího prvku je Document, která určuje dokument k náhledu. Dokument musí být objektem PrintDocument. Chcete-li zobrazit dialogové okno, musíte zavolat jeho metodu ShowDialog. Anti-aliasing může usnadnit zobrazení textu, ale může také zpomalit zobrazení; chcete-li jej použít, nastavte vlastnost UseAntiAlias na true.

Některé vlastnosti jsou k dispozici prostřednictvím PrintPreviewControl, které PrintPreviewDialog obsahuje. (Nemusíte přidávat PrintPreviewControl do formuláře; je automaticky součástí PrintPreviewDialog, když přidáte dialog do formuláře.) Mezi vlastnosti dostupné prostřednictvím PrintPreviewControl, patří vlastnosti Columns a Rows, které určují počet stránek zobrazených vodorovně a svisle v ovládacím prvku. K vlastnosti Columns můžete přistupovat jako PrintPreviewDialog1.PrintPreviewControl.Columns v jazyce Visual Basic, printPreviewDialog1.PrintPreviewControl.Columns v jazyce Visual C# nebo printPreviewDialog1->PrintPreviewControl->Columns v jazyce Visual C++.

Výkon PrintPreviewDialog

Za následujících podmínek se PrintPreviewDialog ovládací prvek inicializuje pomalu:

  • Používá se síťová tiskárna.
  • Uživatelské předvolby pro tuto tiskárnu, například duplexní nastavení, jsou změněny.

Optimalizace se nepoužije, pokud k úpravě nastavení stránky použijete QueryPageSettings událost.

Pokud chcete použít optimalizaci, nastavte Switch.System.Drawing.Printing.OptimizePrintPreview možnost konfigurace modulu runtime na true.

Tuto možnost můžete nastavit v konfiguračním souboruruntimeconfig.json nebo v souboru projektu aplikace:

  • Nakonfigurujte výchozí nastavení v souboru projektu.

    Chcete-li použít nastavení v souboru projektu, povolte vygenerování konfigurace modulu runtime tím, že nastavíte <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles> v rámci <PropertyGroup>. Pak přidejte <RuntimeHostConfigurationOption> nastavení do <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>

  • Nakonfigurujte výchozí hodnotu ve zdrojovém souboru runtimeconfig.template.json .

    Pokud chcete nakonfigurovat výchozí nastavení pro vaši aplikaci, použijte nastavení ve zdrojovém souboruruntimeconfig.template.json . Při kompilaci nebo publikování aplikace se soubor šablony použije k vygenerování konfiguračního souboru modulu runtime.

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

    Další informace o konfiguraci modulu runtime naleznete v tématu Nastavení konfigurace modulu runtime .NET.

  • Nakonfigurujte publikovanou aplikaci s výstupním souborem {appname}.runtimeconfig.json .

    Chcete-li nakonfigurovat publikovanou aplikaci, použijte nastavení v části souboru {appname}.runtimeconfig.jsonruntimeOptions/configProperties.

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

    Další informace o konfiguraci modulu runtime naleznete v tématu Nastavení konfigurace modulu runtime .NET.

Viz také

  • Last updated on