Udostępnij przez

Omówienie kontrolki PrintPreviewDialog (Formularze Windows)

Kontrolka Formularze PrintPreviewDialog systemu Windows to wstępnie skonfigurowane okno dialogowe służące do wyświetlania sposobu wyświetlania dokumentu PrintDocument podczas drukowania. Użyj jej w aplikacji opartej na systemie Windows jako prostego rozwiązania zamiast konfigurowania własnego okna dialogowego. Kontrolka zawiera przyciski drukowania, powiększania, wyświetlania jednej lub wielu stron i zamykania okna dialogowego.

Kluczowe właściwości i metody

Kluczowa właściwość kontrolki to Document, która ustawia dokument do podglądu. Dokument musi być obiektem PrintDocument. Aby wyświetlić okno dialogowe, należy wywołać jego ShowDialog metodę. Antyaliasing może sprawić, że tekst będzie wygładzony, ale może również spowolnić wyświetlanie; aby go użyć, ustaw właściwość UseAntiAlias na wartość true.

Niektóre właściwości są dostępne za pośrednictwem PrintPreviewControl, które zawiera PrintPreviewDialog. Nie musisz dodawać PrintPreviewControl do formularza; jest on automatycznie zawarty w PrintPreviewDialog, gdy dodajesz okno dialogowe do formularza. Przykładami właściwości dostępnych przez PrintPreviewControl są właściwości Columns i Rows, które określają liczbę stron wyświetlanych poziomo i pionowo na kontrolce. Dostęp do właściwości Columns można uzyskać jako PrintPreviewDialog1.PrintPreviewControl.Columns w języku Visual Basic, printPreviewDialog1.PrintPreviewControl.Columns w języku Visual C# lub printPreviewDialog1->PrintPreviewControl->Columns w języku Visual C++.

Wydajność aplikacji PrintPreviewDialog

W następujących warunkach kontrolka inicjuje PrintPreviewDialog się powoli:

  • Używana jest drukarka sieciowa.
  • Preferencje użytkownika dla tej drukarki, takie jak ustawienia dwukierunkowe, są modyfikowane.

Optymalizacja nie jest stosowana, jeśli używasz zdarzenia QueryPageSettings do modyfikowania ustawień strony.

Aby zastosować optymalizację, ustaw opcję konfiguracji czasu wykonania na Switch.System.Drawing.Printing.OptimizePrintPreview, true.

Tę opcję można ustawić w pliku konfiguracji runtimeconfig.json lub pliku projektu aplikacji:

  • Skonfiguruj wartość domyślną w pliku projektu.

    Aby zastosować ustawienie w pliku projektu, włącz generowanie konfiguracji środowiska uruchomieniowego, ustawiając wartość <GenerateRuntimeConfigurationFiles>true</GenerateRuntimeConfigurationFiles> na .<PropertyGroup> Następnie dodaj ustawienia <RuntimeHostConfigurationOption> do elementu <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>

  • Skonfiguruj wartość domyślną w pliku źródłowym runtimeconfig.template.json .

    Aby skonfigurować ustawienie domyślne dla aplikacji, zastosuj ustawienie w pliku źródłowym runtimeconfig.template.json . Po skompilowaniu lub opublikowaniu aplikacji plik szablonu jest używany do generowania pliku konfiguracji środowiska uruchomieniowego.

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

    Aby uzyskać więcej informacji na temat konfiguracji środowiska uruchomieniowego, zobacz Ustawienia konfiguracji środowiska uruchomieniowego platformy .NET.

  • Skonfiguruj opublikowaną aplikację przy użyciu pliku wyjściowego {appname}.runtimeconfig.json .

    Aby skonfigurować opublikowaną aplikację, zastosuj ustawienie w sekcji {appname}.runtimeconfig.json pliku runtimeOptions/configProperties .

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

    Aby uzyskać więcej informacji na temat konfiguracji środowiska uruchomieniowego, zobacz Ustawienia konfiguracji środowiska uruchomieniowego platformy .NET.

Zobacz także

  • Last updated on