Skip to main content

SystemPrintDialogRunner.Run(PrintDocument, UserLookAndFeel, IWin32Window, PrintDialogAllowFlags) Method

Invokes a standard system Print dialog.

Namespace: DevExpress.XtraPrinting.Preview

Assembly: DevExpress.XtraPrinting.v23.2.dll

NuGet Packages: DevExpress.Win.Navigation, DevExpress.Win.Printing

Declaration

public override DialogResult Run(
    PrintDocument document,
    UserLookAndFeel lookAndFeel,
    IWin32Window owner,
    PrintDialogAllowFlags flags
)

Parameters

Name Type Description
document PrintDocument

A PrintDocument.

lookAndFeel UserLookAndFeel

A UserLookAndFeel.

owner IWin32Window

An object implementing the IWin32Window interface that is the dialog owner.

flags PrintDialogAllowFlags

A PrintDialogAllowFlags enumeration value that enables editing of specific settings in the invoked dialog.

Returns

Type Description
DialogResult

A DialogResult enumeration value that specifies identifiers to indicate the return value of a dialog box.

Remarks

The following image illustrates the Print dialog invoked by the DefaultPrintDialogRunner.Run method as an alternative to the standard PrintDialog that is returned by the SystemPrintDialogRunner.Run.

custom-print-dialog

Example

To make the PrintTool.PrintDialog method invoke the standard system Print dialog, add the following code to the application’s Program.cs unit (Program.vb in Visual Basic).

This will replace the DefaultPrintDialogRunner, returned by the PrintDialogRunner.Instance property, with a SystemPrintDialogRunner.

using DevExpress.XtraPrinting.Preview;
// ...

static void Main(string[] args) {
    PrintDialogRunner.Instance = new SystemPrintDialogRunner();
    // ...
}
See Also