A custom WPF print dialog with lightning-fast real-time preview. Support a full scope of print settings for modern demands, with the flexibility for complete customization. Provide the ability to dynamically adjust documents according to changes in print settings. Empowers the user experience with a responsive, elegant, and configurable interface.
- WPF-UI ≥ 4.0.3, < 5.0.0
For versions ≥ 3.0.0, the versioning of PrintDialogX conforms to the following scheme:
| Generation | Major | Minor | ||
|---|---|---|---|---|
| 3 | . | 4 | . | 0 |
| (backward-incompatible) | (backward-incompatible) | (backward-compatible) | ||
| Significant codebase refactors. | Severe bug fixes and core improvements. | Mild changes. |
The changelogs are available at the Releases.
PrintDialogX is a powerful and user-friendly print dialog tailored for modern demands. It supports all essential and advanced features expected from a next-generation print dialog, delivering real-time document previews at lightning speed. Without relying on the built-in controls for document hosting and printing, this next-level print dialog is able to truly take full control over the print pipeline, enabling more thorough customizations and better performance.
The print settings responsively adapt to the capabilities of specific printers, adhering to industry standards in addition to intelligently maintaining the user's preferences. With the ability to respond to any changes in print settings made by the user, documents remain flexible and dynamically reactive to these adjustments. Powered by WPF-UI, the compelling interface allows complete personalization to suit specific scenarios, while its carefully crafted structure minimizes lag and ensures a fluid, modern printing experience.
- Comprehensive printer selection
- Detailed printer information with graphics
- Options to add new printers or configure existing printers
- Personalizable print settings
- Full range of configurations for modern print dialogs
- Modifiable settings organization for personal needs
- Interactive real-time preview
- Responsive high-resolution zooming
- Customizable document arrangement and navigation
- Dynamically updatable documents
- Handler for print setting changes to adjust the contents on the fly
An example project is included under the PrintDialogX.Test folder, with custom configurations to generate the print dialog accordingly, and three template documents to showcase the capability of PrintDialogX.
The usage of PrintDialogX is straightforward:
// Create a new document.
PrintDialogX.PrintDocument document = new PrintDialogX.PrintDocument();
// Create the pages of the document.
for (int i = 0; i < 100; i++)
{
PrintDialogX.PrintPage page = new PrintDialogX.PrintPage();
page.Content = GenerateContent(i);
document.Pages.Add(page);
}
// Initialize the print dialog.
PrintDialogX.PrintDialog dialog = new PrintDialogX.PrintDialog();
dialog.Document = document;
// Open the print dialog.
dialog.ShowDialog();
// Retrieve the result of the operation.
bool isSuccess = dialog.Result.IsSuccess;
int paperCount = dialog.Result.PaperCount;PrintDialogX supports the ability to delay the document generation until the dialog is loaded, so that a spinner is shown during the generation:
// Initialize the print dialog.
PrintDialogX.PrintDialog dialog = new PrintDialogX.PrintDialog();
// Open the print dialog.
dialog.ShowDialog(async () =>
{
// Create a new document.
PrintDialogX.PrintDocument document = new PrintDialogX.PrintDocument();
// Create the pages of the document asynchronously.
for (int i = 0; i < 100; i++)
{
PrintDialogX.PrintPage page = new PrintDialogX.PrintPage();
page.Content = await GenerateContentAsync(i);
document.Pages.Add(page);
// Allow for other UI updates.
await Dispatcher.Yield();
}
dialog.Document = document;
});It is easy to customize the document information (by default, the document is dynamically sized and takes up the entirety of the available space, but one may also choose to fix the size of the document):
document.DocumentName = "Untitled Document";
document.DocumentSize = new PrintDialogX.Enums.Size(PrintDialogX.Enums.Size.DefinedSize.NorthAmericaLetter);
document.DocumentMargin = 50.0;PrintDialogX raises an event when the print settings are changed:
document.PrintSettingsChanged += HandlePrintSettingsChanged;private async void HandlePrintSettingsChanged(object? sender, PrintDialogX.PrintSettingsEventArgs e)
{
if (sender is not PrintDialogX.PrintDocument document)
{
return;
}
// Delay the preview generation until the document is updated.
e.IsUpdating = null;
int index = 0;
foreach (PrintDialogX.PrintPage page in document.Pages)
{
// Update the content according to the print settings.
page.Content = await UpdateContentAsync(index, e.CurrentSettings);
index++;
// Allow for other UI updates.
await Dispatcher.Yield();
}
// Signal the preview generation to update.
e.IsUpdating = true;
}The default settings can be set individually (certain settings accept null and use null by default, which represents that the default configuration of the selected printer will be used):
dialog.PrintSettings.Copies = 2;
dialog.PrintSettings.Collation = PrintDialogX.Enums.Collation.Collated;
dialog.PrintSettings.Pages = PrintDialogX.Enums.Pages.CustomPages;
dialog.PrintSettings.CustomPages = "2-5, 8";
dialog.PrintSettings.Layout = PrintDialogX.Enums.Layout.Landscape;
dialog.PrintSettings.Color = PrintDialogX.Enums.Color.Grayscale;PrintDialogX offers the ability to both customize the window of the print dialog and the exact interface to be used within the print dialog:
// Initialize the print dialog.
PrintDialogX.PrintDialog dialog = new PrintDialogX.PrintDialog(window =>
{
// Customize the dialog window.
window.Topmost = true;
window.ShowInTaskbar = false;
});
// Customize the interface.
dialog.InterfaceSettings.Title = "Test Print";
dialog.InterfaceSettings.BasicSettings = [PrintDialogX.InterfaceSettings.Option.Printer, PrintDialogX.InterfaceSettings.Option.Void, PrintDialogX.InterfaceSettings.Option.Pages, PrintDialogX.InterfaceSettings.Option.Layout, PrintDialogX.InterfaceSettings.Option.Size];
dialog.InterfaceSettings.AdvancedSettings = [PrintDialogX.InterfaceSettings.Option.Color, PrintDialogX.InterfaceSettings.Option.Quality, PrintDialogX.InterfaceSettings.Option.Scale, PrintDialogX.InterfaceSettings.Option.Margin, PrintDialogX.InterfaceSettings.Option.DoubleSided, PrintDialogX.InterfaceSettings.Option.Type, PrintDialogX.InterfaceSettings.Option.Source];PrintDialogX is licensed under the MIT License.