Click here to Skip to main content
13,005,192 members (59,817 online)
Click here to Skip to main content
Add your own
alternative version

Stats

37.1K views
17 bookmarked
Posted 20 Apr 2009

Print a WinForms User Control

, 20 Apr 2009
Rate this:
Please Sign up or sign in to vote.
Here's how to print your custom user control on a full page.

Introduction

A few weeks ago, I had a seemingly simple problem. My application has a complex user control, representing a report, and my client decided he wanted to be able to print it to a page. I thought, "how hard could that be?"

Background

After an hour vainly attempting to figure this out on my own, followed by queries to old colleagues, then some fruitless searching through this forum and others, I had found only a few hints and code snippets. I could print the control - but it was really tiny, and sitting in the corner of the page. Obviously, I needed to figure out how to scale the thing properly. So, I rolled up my sleeves and dove in ... and here we are.

A basic requirement before you will find this article helpful is to have a user control (or form) that makes sense to print to a full page. Some small controls will look absurd when expanded to a full page; some large ones that scroll off the screen will likely be illegible when shrunk to fit on a single sheet. But, the basic technique that I present should give you clues as to how you might treat those cases.

Using the code

Printing a scaled object actually turns out to be fairly simple ... once you already know how to do it.

The basic concept for all custom printing is to use the PrintPage event from a PrintDocument, probably owned by your form. Within your event handler, you can call a method of your custom control's class, where you can encapsulate any special needs that the control might have.

In my form, I have a property, CurrentReportControl, which points to the currently-viewed report, and so my PrintPage event handler looks like this:

/// <summary>
/// Print document wants to print a page.
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void printDocument1_PrintPage(object sender, PrintPageEventArgs e)
{
  CurrentReportControl.PrintToGraphics(e.Graphics, e.MarginBounds);
}

The PrintPageEventArgs object provides a Graphics object on which to draw whatever you want, and it defines the page margins as well. I pass these to the PrintToGraphics() method of my custom control.

This method draws the control to a Bitmap, and then draws the bitmap to the Graphics object with the proper scaling. Care is taken to maximize the use of the printed page, without altering the aspect ratio of the control as viewed on the screen:

/// <summary>
/// Print the control's view to a Graphics object.
/// </summary>
/// <param name="graphics">Graphics object to draw on.</param>
/// <param name="bounds">Rectangle to print in.</param>
public void PrintToGraphics(Graphics graphics, Rectangle bounds)
{
  Bitmap bitmap = new Bitmap(this.Width, this.Height);
  this.DrawToBitmap(bitmap, new Rectangle(0, 0, bitmap.Width, bitmap.Height));
  Rectangle target = new Rectangle(0, 0, bounds.Width, bounds.Height);
  double xScale = (double)bitmap.Width / bounds.Width;
  double yScale = (double)bitmap.Height / bounds.Height;
  if (xScale < yScale)
    target.Width = (int)(xScale * target.Width / yScale);
  else
    target.Height = (int)(yScale * target.Height / xScale);
  graphics.PageUnit = GraphicsUnit.Display;
  graphics.DrawImage(bitmap, target);
}

Points of interest

An interesting topic that I found myself distracted by was the Graphics.PageUnit property, which defines various scalings for different graphical objects, such as display, printer, etc.

History

  • 1.0 - First release.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

tystent
Software Developer (Senior)
United States United States
After seventeen years dinking around in electrical designs and software at a major defense contractor, I then spent six years making video slots do things they were never meant to do at a gaming company in Las Vegas. Now I'm a software consultant from home, since 2005.

You may also be interested in...

Pro

Comments and Discussions

 
Questiongreat script & and an optimization Pin
casiosmu14-Apr-16 21:24
membercasiosmu14-Apr-16 21:24 
Questionthank you very much Pin
Member 98257889-May-15 17:42
memberMember 98257889-May-15 17:42 
QuestionTexts in printed page not clear! Pin
Member 1069153222-Mar-14 11:45
memberMember 1069153222-Mar-14 11:45 
AnswerCurrentReportControl Pin
n shiva Ram6-Nov-14 20:08
membern shiva Ram6-Nov-14 20:08 
Question"Ported" to vb.net Pin
GojiraDeMonstah14-Mar-13 12:07
memberGojiraDeMonstah14-Mar-13 12:07 
GeneralMy vote of 5 Pin
Member 780770625-Jun-12 5:47
memberMember 780770625-Jun-12 5:47 
QuestionHow to print a user control which has scrollbar? Pin
busbby11-Sep-10 16:30
memberbusbby11-Sep-10 16:30 
AnswerRe: How to print a user control which has scrollbar? Pin
tystent13-Sep-10 15:51
membertystent13-Sep-10 15:51 
GeneralRe: How to print a user control which has scrollbar? Pin
busbby14-Sep-10 0:22
memberbusbby14-Sep-10 0:22 
GeneralRe: How to print a user control which has scrollbar? Pin
tystent4-Oct-10 13:38
membertystent4-Oct-10 13:38 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.170627.1 | Last Updated 21 Apr 2009
Article Copyright 2009 by tystent
Everything else Copyright © CodeProject, 1999-2017
Layout: fixed | fluid