PrintView Property

Gets or sets the PrintView, which will be used when printing or exporting the grid.

Syntax

Visual Basic
C#

'Declaration
 
Public Property PrintView As PrintViewBase

'Usage
 
Dim instance As DataGridControl
Dim value As PrintViewBase
 
instance.PrintView = value
 
value = instance.PrintView

public PrintViewBase PrintView {get; set;}

Property Value

A PrintViewBase representing the view that will be used when printing or exporting the grid. By default, a null reference (Nothing in Visual Basic).

Remarks

Grids will be printed using the GenericPrintTheme.

Example

All examples in this topic assume that the grid is bound to the Orders table of the Northwind database, unless stated otherwise.

The following example demonstrates how to use a PrintTableView and configure it to display a title in the page headers and the page number in the page footers. The elements added to these sections must be added as DataTemplates and will be repeated on each page. The Print method will be called in the button's Click event, whose implementation is not provided.The following example demonstrates how to change the default text displayed in the progress window when the Print or ExportToXps methods are called. The implementation of the PrintGrid method is not provided.To style a DataGridControl's PrintView, one should set it to a custom PrintTableView resource, defining a PageStyle into which you insert implicit styles for the print grid. For example, the following will turn all datacells in the PrintView DeepPink:Then, when you declare your DataGridControl:

XAML
XAML
XAML
XAML

<Grid xmlns:xcdg="http://schemas.xceed.com/wpf/xaml/datagrid"
      xmlns:local="clr-namespace:Xceed.Wpf.Documentation">
  <Grid.Resources>
    <xcdg:DataGridCollectionViewSource x:Key="cvs_employees"
                                    Source="{Binding Source={x:Static Application.Current},
                                                        Path=Employees}"/>         
  </Grid.Resources>
 
  <DockPanel>
    <Button Content="Print Grid"
            Click="PrintGrid"
            DockPanel.Dock="Top"/>
      <xcdg:DataGridControl x:Name="EmployeesGrid"
                            ItemsSource="{Binding Source={StaticResource cvs_employees}}">

       <xcdg:DataGridControl.PrintView>
         <xcdg:PrintTableView>
           <xcdg:PrintTableView.PageHeaders>
             <DataTemplate>
               <TextBlock Text="Xceed WPF Documentation"
                          HorizontalAlignment="Center"
                          FontWeight="Bold"
                          FontSize="20"/>
             </DataTemplate>
             <DataTemplate>
               <TextBlock Text="Printing Example"
                          HorizontalAlignment="Center"
                          FontSize="16"/>
             </DataTemplate>
           </xcdg:PrintTableView.PageHeaders>
           <xcdg:PrintTableView.PageFooters>
           <DataTemplate>
             <TextBlock Text="{xcdg:ViewBinding CurrentPageNumber}"
                        HorizontalAlignment="Right"/>
           </DataTemplate>
         </xcdg:PrintTableView.PageFooters>
       </xcdg:PrintTableView>
     </xcdg:DataGridControl.PrintView>
    </xcdg:DataGridControl>
  </DockPanel>
</Grid>

<Grid xmlns:xcdg="http://schemas.xceed.com/wpf/xaml/datagrid">
  <Grid.Resources>
    <xcdg:DataGridCollectionViewSource x:Key="cvs_employees"
                                    Source="{Binding Source={x:Static Application.Current},
                                                     Path=Employees}"/>
  </Grid.Resources>
  <DockPanel>
    <Button Content="Print Employee Information"
            Click="PrintGrid"
            DockPanel.Dock="Top"/>
    <xcdg:DataGridControl x:Name="EmployeesGrid"
                          ItemsSource="{Binding Source={StaticResource cvs_employees}}"
                          DockPanel.Dock="Bottom">

      <xcdg:DataGridControl.PrintView>
        <xcdg:PrintTableView>
          <xcdg:PrintTableView.ProgressWindowDescription>
            <StackPanel Orientation="Horizontal">
              <TextBlock Text="Printing page "/>
              <TextBlock Text="{Binding CurrentPageNumber}"/>
              <TextBlock Text=" of employee information..."/>
            </StackPanel>
          </xcdg:PrintTableView.ProgressWindowDescription>
        </xcdg:PrintTableView>
      </xcdg:DataGridControl.PrintView>
    </xcdg:DataGridControl>
  </DockPanel>
</Grid>

<xcdg:PrintTableView x:Key="customPrintView">
    <xcdg:PrintTableView.PageStyle>
    <Style>
        <Style.Resources>
            <Style TargetType="{x:Type xcdg:DataCell}">
                <Setter Property="Background" Value="DeepPink" />
            </Style>
        </Style.Resources>
    </Style>
    </xcdg:PrintTableView.PageStyle>
</xcdg:PrintTableView>

<xcdg:DataGridControl PrintView="{Binding Source={StaticResource customPrintView}}" />

Requirements

Target Platforms: Windows 11, Windows, 10, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

DataGridControl Class
DataGridControl Members

Methods

ExportToXps Method
Print Method