C# 5.0 Programmer's Reference

366 ❘ CHAPTER 16 Printing
(continued)
Method
DrawImageUnscaled
DrawLine
DrawLines
DrawPath
DrawPie
DrawPolygon
DrawRectangle
DrawRectangles
DrawString
Description
Draws an image without scaling. If you know that you will not
resize the image, this is faster than DrawImage.
Draws a line.
Draws a series of connected lines. This is much faster than using
DrawLine repeatedly.
Draws a GraphicsPath object.
Draws a pie slice taken from an ellipse.
Draws a polygon. This is similar to DrawLines except it connects
the last point to the first point.
Draws a rectangle with horizontal and vertical sides. (In other
words, it can’t draw rotated rectangles.)
Draws a series of rectangles. This is much faster than using
DrawRectangle repeatedly.
Draws text.
The methods listed in the preceding table draw the outline of something such as a line, rectangle,
or ellipse. The Graphics class provides corresponding methods that fill many of these shapes. For
example, the DrawRectangle method outlines a rectangle, and the corresponding FillRectangle
method fills a rectangle. The filling methods include FillClosedCurve, FillEllipse, FillPath,
FillPie, FillPolygon, FillRectangle, and FillRectangles.
The Draw methods take a pen as a parameter and use that pen to determine how the outline is drawn.
In contrast, the Fill methods take a brush as a parameter and use the brush to determine how to fill
the area.
The one exception is the DrawString method, which uses a brush to fill text even though its name
begins with Draw.
The sections “Pens” and “Brushes” later in this chapter describe pens and brushes in greater detail.
See the online help for specific information about the Graphics class’s drawing and filling
methods. You can find links to the pages describing these methods at the Graphics class’s web
page msdn.microsoft.com/library/system.drawing.graphics.
Obtaining Graphics Objects
There are several ways a program can obtain a Graphics object on which to draw. You’ve already
seen that the PrintDocument’s PrintPage event handler provides an e.Graphics parameter.
www.it-ebooks.info