PrintPreviewControl Constructor

PrintPreviewControl Constructor ()


Initializes a new instance of the PrintPreviewControl class.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public PrintPreviewControl()

When you create an instance of the PrintPreviewControl class, the following read/write properties are initialized.


Default Value











You can change the value for any of these properties through a separate call to the property.

The following code example demonstrates the Document, UseAntiAlias, and Zoom properties of the PrintPreviewControl. To run this example, place the following code in a form and call the InitializePrintPreviewControl method from the form’s constructor or Load event-handling method.

// Declare the PrintPreviewControl object and the 
// PrintDocument object.
internal PrintPreviewControl PrintPreviewControl1;
private System.Drawing.Printing.PrintDocument docToPrint = 
	new System.Drawing.Printing.PrintDocument();

private void InitializePrintPreviewControl()

	// Construct the PrintPreviewControl.
	this.PrintPreviewControl1 = new PrintPreviewControl();

	// Set location, name, and dock style for PrintPreviewControl1.
	this.PrintPreviewControl1.Location = new Point(88, 80);
	this.PrintPreviewControl1.Name = "PrintPreviewControl1";
	this.PrintPreviewControl1.Dock = DockStyle.Fill;

	// Set the Document property to the PrintDocument 
	// for which the PrintPage event has been handled.
	this.PrintPreviewControl1.Document = docToPrint;

	// Set the zoom to 25 percent.
	this.PrintPreviewControl1.Zoom = 0.25;

	// Set the document name. This will show be displayed when 
	// the document is loading into the control.
	this.PrintPreviewControl1.Document.DocumentName = "c:\\someFile";

	// Set the UseAntiAlias property to true so fonts are smoothed
	// by the operating system.
	this.PrintPreviewControl1.UseAntiAlias = true;

	// Add the control to the form.

	// Associate the event-handling method with the
	// document's PrintPage event.
	this.docToPrint.PrintPage += 
		new System.Drawing.Printing.PrintPageEventHandler(

// The PrintPreviewControl will display the document
// by handling the documents PrintPage event
private void docToPrint_PrintPage(
	object sender, System.Drawing.Printing.PrintPageEventArgs e)

	// Insert code to render the page here.
	// This code will be called when the control is drawn.

	// The following code will render a simple
	// message on the document in the control.
	string text = "In docToPrint_PrintPage method.";
	System.Drawing.Font printFont = 
		new Font("Arial", 35, FontStyle.Regular);

	e.Graphics.DrawString(text, printFont,
		Brushes.Black, 10, 10);

.NET Framework
Available since 1.1
Return to top
© 2015 Microsoft