| Spread Windows Forms 8.0 Product Documentation > Developer's Guide > Managing Printing > Customizing the Appearance of the Printing > Understanding the Printing Options |
You can customize the printing by setting the properties of a PrintInfo object and setting the PrintInfo property of a sheet to that object. The PrintInfo object has the settings for customizing the printing of a sheet.
The PrintInfo object provides the following properties for customizing the printing:
| Property | Description |
|---|---|
| AbortMessage | Gets or sets the message to display for the abort dialog. See Displaying an Abort Message for the User. |
| BestFitCols | Gets or sets whether column widths are adjusted to fit the longest string width for printing. See Optimizing the Printing Using Size. |
| BestFitRows | Gets or sets whether row heights are adjusted to fit the tallest string height for printing. See Optimizing the Printing Using Size. |
| Centering | Gets or sets whether to center the print out. See Customizing the Printed Page Layout. |
| Colors | Gets or sets the list of colors that can be used in a custom header or footer text. See Customizing the Printed Page Header or Footer. |
| ColStart and ColEnd | Used for printing a portion of the sheet. See Printing a Range of Cells on a Sheet. |
| FirstPageNumber | Gets or sets the page number to print on the first page. See Customizing the Printed Page Layout. |
| Footer | Used for providing footers on printed pages. See Customizing the Printed Page Header or Footer. |
| Header | Used for providing headers on printed pages. See Customizing the Printed Page Header or Footer. |
| Images | Gets or sets the list of images that can be used in a custom headers or footers. See Customizing the Printed Page Header or Footer. |
| JobName | Gets or sets the name of the print job. See Customizing the Print Job Settings. |
| Margin | Gets or sets the margins for printing. See Customizing the Printed Page Layout. |
| Opacity | Gets or sets the opacity used when printing this sheet; this is used to print a watermark first and then the sheet contents. See Customizing the Printed Page Layout. |
| Orientation | Gets or sets the page orientation used for printing. See Customizing the Print Job Settings. |
| PageStart and PageEnd | Used for printing a page range. See Printing Particular Pages. |
| PageOrder | Gets or sets the order in which pages print. See Customizing the Print Job Settings. |
| PaperSize | Gets or sets the paper size to use. See Customizing the Print Job Settings. |
| PaperSource | Gets or sets the paper source to use. See Customizing the Print Job Settings. |
| Preview | Used to provide print preview. See Providing a Preview of the Printing. |
| Printer | Gets or sets the name of the printer to use for printing. See Customizing the Print Job Settings. |
| PrintNotes | Gets or sets whether to print the cell notes. See Printing a Sheet with Cell Notes. |
| PrintShapes | Gets or sets whether to print floating objects. See Printing a Sheet with Shapes. |
| PrintType | Gets or sets what is to be printed. See Printing Particular Pages. |
| RepeatColStart and RepeatColEnd | Gets or sets whether to print the same set of columns on each page. See Customizing the Printed Page Header or Footer. |
| RepeatRowStart and RepeatRowEnd | Gets or sets whether to print the same set of rows on each page. See Customizing the Printed Page Header or Footer. |
| RowStart and RowEnd | Used for printing a portion of the sheet. See Printing a Range of Cells on a Sheet. |
| ShowBorder | Gets or sets whether to print a border around the sheet. See Customizing the Printed Page Layout. |
| ShowColor | Gets or sets whether to print the colors as they appear on the screen. See Customizing the Printed Page Layout. |
| ShowColumnHeader and ShowRowHeader | Gets or sets whether to print the column headers and row headers. See Customizing the Printed Page Layout. |
| ShowGrid | Gets or sets whether to print the sheet grid lines. See Customizing the Printed Page Layout. |
| ShowPrintDialog | Gets or sets whether to display a print dialog before printing. See Displaying a Print Dialog for the User. |
| ShowShadows | Gets or sets whether to print the header shadows. See Customizing the Printed Page Layout. |
| SmartPrintPagesTall | Gets or sets how many pages tall to print. See Optimizing the Printing Using Rules. |
| SmartPrintPagesWide | Gets or sets how many pages wide to print. See Optimizing the Printing Using Rules. |
| SmartPrintRules | Used for setting up the rules for optimizing the printing. See Optimizing the Printing Using Rules. |
| UseMax | Gets or sets whether to print only rows containing data. See Printing an Area of the Sheet. |
| UseSmartPrint | Used for turning on the rules for optimizing the printing. See Optimizing the Printing Using Rules. |
| ZoomFactor | Gets or sets the zoom factor used for printing this sheet. See Customizing the Printed Page Layout. |
This example code creates a PrintInfo object, sets properties to specify to not print grid lines or row headers, and to print only cells with data in them.
| C# |
Copy Code
|
|---|---|
// Create PrintInfo object and set properties. FarPoint.Win.Spread.PrintInfo printset = new FarPoint.Win.Spread.PrintInfo(); printset.ShowGrid = false; printset.ShowRowHeader = FarPoint.Win.Spread.PrintHeader.Hide; printset.UseMax = true; // Set the PrintInfo property for the first sheet. fpSpread1.Sheets[0].PrintInfo = printset; // Print the sheet. fpSpread1.PrintSheet(0); |
|
| VB |
Copy Code
|
|---|---|
' Create PrintInfo object and set properties. Dim printset As New FarPoint.Win.Spread.PrintInfo() printset.ShowGrid = False printset.ShowRowHeader = FarPoint.Win.Spread.PrintHeader.Hide printset.UseMax = True ' Set the PrintInfo property for the first sheet. FpSpread1.Sheets(0).PrintInfo = printset ' Print the sheet. FpSpread1.PrintSheet(0) |
|
This example code creates a PrintInfo object, sets properties to specify to not print grid lines or row headers, and to print only cells with data in them.
| C# |
Copy Code
|
|---|---|
// Create PrintInfo object and set properties. FarPoint.Win.Spread.PrintInfo printset = new FarPoint.Win.Spread.PrintInfo(); printset.ShowGrid = false; printset.ShowRowHeader = FarPoint.Win.Spread.PrintHeader.Hide; printset.UseMax = true; // Create SheetView object and assign it to the first sheet. FarPoint.Win.Spread.SheetView SheetToPrint = new FarPoint.Win.Spread.SheetView(); SheetToPrint.PrintInfo = printset; fpSpread1.Sheets[0] = SheetToPrint; // Print the sheet. fpSpread1.PrintSheet(0); |
|
| VB |
Copy Code
|
|---|---|
' Create PrintInfo object and set properties. Dim printset As New FarPoint.Win.Spread.PrintInfo() printset.ShowGrid = False printset.ShowRowHeader = FarPoint.Win.Spread.PrintHeader.Hide printset.UseMax = True ' Create SheetView object and assign it to the first sheet. Dim SheetToPrint As New FarPoint.Win.Spread.SheetView() SheetToPrint.PrintInfo = printset FpSpread1.Sheets(0) = SheetToPrint ' Print the sheet. FpSpread1.PrintSheet(0) |
|
The Sheet Print dialog appears.