Spread Windows Forms 6.0 Product Documentation
PrintBackground Event
See Also  Example Support Options
FarPoint.Win.Spread Assembly > FarPoint.Win.Spread Namespace > FpSpread Class : PrintBackground Event

Glossary Item Box

Occurs before each page is printed.


Visual Basic (Declaration) 
Public Event PrintBackground As PrintBackgroundEventHandler
Visual Basic (Usage)Copy Code
Dim instance As FpSpread
Dim handler As PrintBackgroundEventHandler
AddHandler instance.PrintBackground, handler
public event PrintBackgroundEventHandler PrintBackground

Event Data

The event handler receives an argument of type PrintBackgroundEventArgs containing data related to this event. The following PrintBackgroundEventArgs properties provide information specific to this event.

Graphics Gets or sets the graphics device that does the printing.
PageNumber Gets or sets the current page being printed.
SheetRectangle Gets or sets the rectangle area representing the sheet.


This event is raised by the OnPrintBackground method before each page is printed.

For more details on the individual event arguments, refer to PrintBackgroundEventArgs members.


This example raises the PrintBackground event.
C#Copy Code
private void fpSpread1_PrintBackground(object sender, FarPoint.Win.Spread.PrintBackgroundEventArgs e) 
if(e.PageNumber == 1) 
FarPoint.Win.Picture pic = new FarPoint.Win.Picture(Image.FromFile("c:\\windows\\zapotec.bmp"),
pic.AlignHorz = FarPoint.Win.HorizontalAlignment.Center;
pic.AlignVert = FarPoint.Win.VerticalAlignment.Center;
pic.Paint(e.Graphics, e.SheetRectangle);
Visual BasicCopy Code
Private Sub FpSpread1_PrintBackground(ByVal sender As Object, ByVal e As
FarPoint.Win.Spread.PrintBackgroundEventArgs) Handles FpSpread1.PrintBackground
If e.PageNumber = 1 Then
Dim pic As New FarPoint.Win.Picture(Image.FromFile("c:/windows/zapotec.bmp"),
pic.AlignHorz = FarPoint.Win.HorizontalAlignment.Center
pic.AlignVert = FarPoint.Win.VerticalAlignment.Center
pic.Paint(e.Graphics, e.SheetRectangle)
End If
End Sub


Target Platforms: 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

See Also

© 2002-2012 ComponentOne, a division of GrapeCity. All Rights Reserved.