Back to Devexpress

GridControl.IsPrintingAvailable Property

windowsforms-devexpress-dot-xtragrid-dot-gridcontrol-8964bcbf.md

latest4.0 KB
Original Source

GridControl.IsPrintingAvailable Property

Indicates whether the grid control can be printed/exported.

Namespace : DevExpress.XtraGrid

Assembly : DevExpress.XtraGrid.v25.2.dll

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

Declaration

csharp
[DXCategory("Printing")]
[Browsable(false)]
public bool IsPrintingAvailable { get; }
vb
<DXCategory("Printing")>
<Browsable(False)>
Public ReadOnly Property IsPrintingAvailable As Boolean

Property Value

TypeDescription
Boolean

true if the grid control can be printed/exported; otherwise, false.

|

Remarks

The grid control can be printed/exported if the XtraPrinting Library is available.

Example

The following example demonstrates how to print a Grid Control or show its Print Preview. To do this, you should use either the GridControl.Print or GridControl.ShowPrintPreview methods.

Note

The Grid Control can be printed and previewed only if the XtraPrinting Library is available. To verify that printing the Grid is possible, use the GridControl.IsPrintingAvailable property.

When printing a Grid, the current print settings will be used to represent a Grid. Note that you can access and change these settings via the GridView.OptionsPrint, BandedGridView.OptionsPrint or CardView.OptionsPrint properties.

csharp
using DevExpress.XtraGrid;
// ...

private void ShowGridPreview(GridControl grid) {
    // Check whether the GridControl can be previewed.
    if (!grid.IsPrintingAvailable) {
        MessageBox.Show("The 'DevExpress.XtraPrinting' library is not found", "Error");
        return;
    }

    // Open the Preview window.
    grid.ShowPrintPreview();
}

private void PrintGrid(GridControl grid) {
    // Check whether the GridControl can be printed.
    if (!grid.IsPrintingAvailable) {
        MessageBox.Show("The 'DevExpress.XtraPrinting' library is not found", "Error");
        return;
    }

    // Print.
    grid.Print();
}
vb
Imports DevExpress.XtraGrid
' ...

Sub ShowGridPreview(ByVal grid As GridControl)
   ' Check whether the GridControl can be previewed.
   If Not grid.IsPrintingAvailable Then
      MessageBox.Show("The 'DevExpress.XtraPrinting' library is not found", "Error")
      Return
   End If

   ' Opens the Preview window.
   grid.ShowPrintPreview()
End Sub

Sub PrintGrid(ByVal grid As GridControl)
   ' Check whether the GridControl can be printed.
   If Not grid.IsPrintingAvailable Then
      MessageBox.Show("The 'DevExpress.XtraPrinting' library is not found", "Error")
      Return
   End If

   ' Print.
   grid.Print()
End Sub

See Also

Print()

ShowPrintPreview()

Export Overview

Printing Overview

GridControl Class

GridControl Members

DevExpress.XtraGrid Namespace