Developer.com content and product recommendations are editorially independent. We may make money when you click on links to our partners. Learn More.
If you draw graphics onto a form, they may be lost when the form — or sections of the form — refreshes. This program shows one way to retain the graphics on the form background.
The program included here, named GraphicsTest, uses a simple Windows form with three buttons. Two of the buttons display graphics in the window and the third exits the program.
When you click the different buttons, shapes are drawn on the window’s background. Figures 1 to 3 below show some results. Because the location and the size of shapes are random, your output will be different. If you click a button again, more shapes will be drawn.
I’m not providing a complete analysis for the listing; however, a couple comments deserve to be made.
This program uses a set of classes used to create and draw graphics. The graphics are drawn onto a basic graphics object named DrawingArea. This is a simple bitmap image that was declared in Line 14. All of the graphics are drawn onto this bitmap rather than directly to the form. The bitmap is then copied to the form. If you draw directly to the form, the graphics may be lost when the form is refreshed.
Stepping back, you’ll see that in Line 4, the System.Drawing namespace is included. This namespace contains many of the graphic routines. Also included are a number of other namespaces, including Windows.Forms, which contains information for doing the Windows form logic.
In Lines 12 to 21, a number of variables are declared that will be used in drawing the graphics and creating controls on the form. Line 20 contains a variable for getting random numbers. In Line 21, myPen is declared as a Pen object. This object will be assigned colors and used to draw shapes later in the listing. In Line 27, you see a new Pen object actually created and the color blue is assigned to it. You can assign any color to the pen.
NOTE: Lots of colors are listed in the Color enumeration. You can assign them in the same way that the color blue was assigned. You can see a list of names for the many available colors at the end of this article.
In Lines 102 to 121, you can see the method btnLine_Click defined. This is actually an event that is executed when the line button is clicked. Because the color of the pen could have been changed, in Line 112, the pen defined earlier is set to the color blue. Before that, in Line 1105, a graphics object was created and assigned the DrawingArea graphic created earlier. This new graphic, oGraphics, will be used to draw upon.
In Lines 109 to 117, there is a loop that executes 50 times. This loop draws a single line each time through the loop by calling the DrawLine method in the graphics object that was created. The parameters being passed are not as complicated as they look in Lines 113 to 116. The first parameter is the pen, myPen. The next four parameters are random numbers. The first and third are numbers between 0 and the width of the form. The second and fourth are between 0 and the height of the form. The first two numbers are the starting point of the line. The last two are the ending point.
After the lines have been drawn, calling the Dispose method cleans up the oGraphics object. This is done in Line 118. Because the graphics object uses a lot of system resources, it is good to force this clean up.
The disposal of the graphics object is followed by a call to this.Invalidate in Line 120. Invalidate makes the current form redraw itself. This causes a paint event to occur. An event handler is created in Lines 185 to 198 for the painting event. In this method, the DrawingArea image is copied to the form’s background image.
The other method events in this listing operate in much the same as in the earlier line listing: Random numbers are used to draw shapes. One other difference is in Lines 134 to 1137. In these lines, instead of setting the pen to a specific color, it is set to a random color. The FromArgb method sets red, green, and blue values for a single color. Because random numbers are used, the result is a random color.
This is a fun listing to play with. You should be able to change the colors, modify the shape sizes and locations, and work with these basic graphics. If you check out the listing in my book, you will find that rectangles and a solid color are added to the listing.
Figure 1 – The GraphicsTest form.
Figure 2 – Output from GraphicsTest.
Figure 3 – Output from GraphicsTest.
This is a fully functioning modification of a larger listing from my book, Teach Yourself the C# Language in 21 Days”.
Listing GraphicsTest.cs — A Program to Draw Colored Shapes on a form.
001: // GraphicsTest.cs002: //003: using System;004: using System.Drawing;005: using System.ComponentModel;006: using System.Windows.Forms;007: 008: namespace GraphicsTest009: {010: public class frmGraphics : System.Windows.Forms.Form011: {012: private Bitmap DrawingArea; // Area to draw on.013: 014: private Button btnCircle;015: private Button btnLine;016: private Button btnOK;017: 018: private System.ComponentModel.Container components = null;019: 020: private System.Random rnd;021: private Pen myPen;022: 023: public frmGraphics()024: {025: InitializeComponent();026: rnd = new System.Random();027: myPen = new Pen(Color.Blue);028: }029: 030: protected override void Dispose( bool disposing )031: {032: if( disposing )033: {034: if (components != null) 035: {036: components.Dispose();037: }038: }039: base.Dispose( disposing );040: }041: 042: private void InitializeComponent()043: {044: this.btnCircle = new System.Windows.Forms.Button();045: this.btnLine = new System.Windows.Forms.Button();046: this.btnOK = new System.Windows.Forms.Button();047: this.SuspendLayout();048: // 049: // btnCircle050: // 051: this.btnCircle.Location = new System.Drawing.Point(8, 32);052: this.btnCircle.Name = "btnCircle";053: this.btnCircle.Size = new System.Drawing.Size(40, 40);054: this.btnCircle.TabIndex = 0;055: this.btnCircle.Text = "Circ";056: this.btnCircle.Click += new System.EventHandler(057: this.btnCircle_Click);058: // 059: // btnLine060: // 061: this.btnLine.Location = new System.Drawing.Point(8, 88);062: this.btnLine.Name = "btnLine";063: this.btnLine.Size = new System.Drawing.Size(40, 40);064: this.btnLine.TabIndex = 1;065: this.btnLine.Text = "Line";066: this.btnLine.Click += new System.EventHandler(this.btnLine_Click);067: // 068: // btnOK069: // 070: this.btnOK.Location = new System.Drawing.Point(296, 296);071: this.btnOK.Name = "btnOK";072: this.btnOK.TabIndex = 0;073: this.btnOK.Text = "OK";074: this.btnOK.Click += new System.EventHandler(this.btnOK_Click);075: // 076: // frmGraphics077: // 078: this.AutoScaleBaseSize = new System.Drawing.Size(5, 13);079: this.ClientSize = new System.Drawing.Size(376, 334);080: this.Controls.Add(this.btnOK);081: this.Controls.Add(this.btnLine);082: this.Controls.Add(this.btnCircle);083: this.FormBorderStyle = FormBorderStyle.Fixed3D;084: this.Name = "frmGraphics";085: this.Text = "Drawing";086: this.Load += new System.EventHandler(this.frmGraphics_Load);087: this.Closed += new System.EventHandler(this.frmGraphics_Closed);088: this.Paint += new System.Windows.Forms.PaintEventHandler(089: this.frmGraphics_Paint);090: this.ResumeLayout(false);091: 092: }093: 094: ///
Color Table
AliceBlue AntiqueWhite Aqua Aquamarine Azure Beige Bisque Black BlanchedAlmond Blue BlueViolet Brown BurlyWood CadetBlue Chartreuse Chocolate Coral CornflowerBlue Cornsilk Crimson Cyan DarkBlue DarkCyan DarkGoldenrod DarkGray DarkGreen DarkKhaki DarkMagenta DarkOliveGreen DarkOrange DarkOrchid DarkRed DarkSalmon DarkSeaGreen DarkSlateBlue DarkSlateGray DarkTurquoise DarkViolet DeepPink DeepSkyBlue DimGray DodgerBlue Firebrick FloralWhite ForestGreen Fuchsia Gainsboro GhostWhite Gold Goldenrod Gray Green GreenYellow Honeydew HotPink IndianRed Indigo Ivory Khaki Lavender LavenderBlush LawnGreen LemonChiffon LightBlue LightCoral LightCyan LightGoldenrodYellow LightGray LightGreen LightPink LightSalmon LightSeaGreen LightSkyBlue LightSlateGray LightSteelBlue LightYellow Lime LimeGreen Linen Magenta Maroon MediumAquamarine MediumBlue MediumOrchid MediumPurple MediumSeaGreen MediumSlateBlue MediumSpringGreen MediumTurquoise MediumVioletRed MidnightBlue MintCream MistyRose Moccasin NavajoWhite Navy OldLace Olive OliveDrab Orange OrangeRed Orchid PaleGoldenrod PaleGreen PaleTurquoise PaleVioletRed PapayaWhip PeachPuff Peru Pink Plum PowderBlue Purple Red RosyBrown RoyalBlue SaddleBrown Salmon SandyBrown SeaGreen SeaShell Sienna Silver SkyBlue SlateBlue SlateGray Snow SpringGreen SteelBlue Tan Teal Thistle Tomato Transparent Turquoise Violet Wheat White WhiteSmokeYellow YellowGreen
Downloads
Download demo project – 3 Kb
Download source – 3 Kb
# # #
