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

Invokes a customized Print dialog.

Namespace: DevExpress.XtraPrinting.Preview

Assembly: DevExpress.XtraPrinting.v24.1.dll

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

Declaration

C#

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

VB.NET

Public Overrides Function Run(
    document As PrintDocument,
    lookAndFeel As UserLookAndFeel,
    owner As IWin32Window,
    flags As PrintDialogAllowFlags
) As DialogResult

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 this method as an alternative to the standard PrintDialog that is returned by the SystemPrintDialogRunner.Run method.

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.

C#

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

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

VB.NET

Imports DevExpress.XtraPrinting.Preview
' ...

Partial Friend Class MyApplication
    <Global.System.Diagnostics.DebuggerStepThroughAttribute()>  _
    Public Sub New()
        ' ...
        PrintDialogRunner.Instance = New SystemPrintDialogRunner()
    End Sub
' ...
End Class