Click here to Skip to main content
Click here to Skip to main content

A Simple Vector-Based LED User Control

, 5 Apr 2013 CPOL
Rate this:
Please Sign up or sign in to vote.
The LEDBulb is a .NET user control for Windows Forms that emulates an LED light. Its purpose is to provide a sleek looking representation of an LED light that is sizable, has a transparent background and can be set to different colors.
LEDBulb/sshot-1.png

Introduction

The LEDBulb is a .NET user control for Windows Forms that emulates an LED light with two states On and Off. The purpose of the control is to provide a sleek looking representation of an LED light that is sizable, has a transparent background and can be set to different colors.

LedBulb bulb = new LedBulb();
bulb.Size = new Size(25, 25);
bulb.Color = Color.LawnGreen;
bulb.On = true;
this.Controls.Add(bulb); 

Sizeable

I recently needed to add a custom user control to a Window Forms project of mine that would represent an LED bulb commonly seen on household electronics. After a quick search, most of the existing controls I found were ugly and used static images, which means they wouldn’t scale well. This control uses the System.Drawing.Drawing2D namespace to draw a vector image so that it not only looks clean but will also scale to any size without affecting the image quality.

LEDBulb/sshot-3.png

Rendering the control starts with drawing a solid circle with our background color. Then we draw a radial gradient over it with our highlight color, transitioning to transparent. To draw the reflection, we draw another radial gradient, from white to transparent, but in a smaller rectangle shifted up and left. To prevent the white gradient from showing up outside the bulb, we set the clip parameter to the bounds of our original circle.

// Fill in the background circle 
g.FillEllipse(new SolidBrush(darkColor), drawRectangle);

// Draw the glow gradient
GraphicsPath path = new GraphicsPath();
path.AddEllipse(drawRectangle);
PathGradientBrush pathBrush = new PathGradientBrush(path);
pathBrush.CenterColor = lightColor;
pathBrush.SurroundColors = new Color[] { Color.FromArgb(0, lightColor) };
g.FillEllipse(pathBrush, drawRectangle);

// Set the clip boundary to the edge of the ellipse
GraphicsPath gp = new GraphicsPath();
gp.AddEllipse(drawRectangle);
g.SetClip(gp);

// Draw the white reflection gradient
GraphicsPath path1 = new GraphicsPath();
path1.AddEllipse(whiteRectangle); // a smaller rectangle set to the top left
PathGradientBrush pathBrush1 = new PathGradientBrush(path);
pathBrush1.CenterColor = Color.FromArgb(180, 255, 255, 255);
pathBrush1.SurroundColors = new Color[] { Color.FromArgb(0, 255, 255, 255) };
g.FillEllipse(pathBrush1, whiteRect);

Transparent Background

It is important that this control has a transparent background. To do this, we need to add a command to the constructor.

SetStyle(ControlStyles.DoubleBuffer
    | ControlStyles.AllPaintingInWmPaint
    | ControlStyles.ResizeRedraw
    | ControlStyles.UserPaint
    | ControlStyles.SupportsTransparentBackColor, true
); 

Customizable Colors

You can customize the color of the LED display by setting the Color property. Setting this property also automatically calculates two other Properties ColorDark and ColorDarkDark which are used for gradients when the control is drawn. These colors are calculated using the using the ControlPaint class, a Control helper class in the System.Windows.Forms namespace.

this.DarkColor = ControlPaint.Dark(_this.Color);
this.DarkDarkColor = ControlPaint.DarkDark(_this.Color); 
LEDBulb/sshot-6.png

LEDBulb/sshot-5.png

Blink

The control has a blink method that will make the control start blinking. You pass the number of milliseconds between blinks. To turn the blinking off just call the blink function again passing 0 as the argument.

led.Blink(2000); // Slow blink
led.Blink(500);  // Fast blink
led.Blink(0);    // Turn off blinking

Points of Interest

This control uses double-buffering by drawing its image to an off-screen bitmap first, then sending the final rendering to the client. Double buffering creates a smoother drawing of the control and avoids flicker when moving or re-sizing. The code to accomplish this is below.

protected override void OnPaint(PaintEventArgs e){
    // Create an offscreen graphics object for double buffering
    Bitmap offScreenBmp = new Bitmap(this.ClientRectangle.Width, 
                this.ClientRectangle.Height);
    System.Drawing.Graphics g = Graphics.FromImage(offScreenBmp);
    g.SmoothingMode = SmoothingMode.HighQuality;

    // Render the control to the off-screen bitmap
    drawControl(g);

    // Draw the image to the screen
    e.Graphics.DrawImageUnscaled(offScreenBmp, 0, 0);    
}  

Links

License

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

Share

About the Author

Steve Marsh
Software Developer (Senior)
United States United States
Stephen Marsh has over 10 years of experience developing enterprise applications built on the .Net framework. He specializes in building expert systems that serve the financial industry.

Comments and Discussions

 
QuestionMy vote of 5 Pinmemberchen_zd2-Apr-14 17:50 
GeneralMy vote of 5 Pinmembertime-master29-Mar-14 7:16 
Questionvote of 5 PinmemberCoffeeShop27-Aug-13 20:52 
GeneralMy vote of 5 PinmemberTechnoGeek0015-Apr-13 18:00 
Questionflashing Pinmemberdano2119-Oct-12 9:28 
AnswerRe: flashing PinmemberSteve Marsh5-Apr-13 9:23 
GeneralMy vote of 5 PinmvpKanasz Robert27-Sep-12 8:39 
QuestionRight side does not show up! PinmemberSaeid Yazdani15-Jul-12 5:16 
AnswerRe: Right side does not show up! PinmemberPuddin Tame23-Mar-13 17:07 
GeneralRe: Right side does not show up! PinmemberSteve Marsh5-Apr-13 9:21 
QuestionThanks PinmemberFastfootskater2-Apr-12 20:25 
GeneralMy vote of 5 [modified] PinmemberJon Gunnar Brekke27-Mar-12 11:14 
GeneralMy vote of 5 PinmemberPaul Tobey21-Sep-11 11:43 
GeneralMy vote of 5 PinmemberCrusty Applesniffer14-Oct-10 9:03 
GeneralFive vote! Pinmemberfredsparkle11-Oct-10 13:46 
GeneralMy vote of 5 Pinmemberfredsparkle11-Oct-10 13:43 
GeneralOne little thing PinmemberKelvin Armstrong9-Oct-10 1:54 
GeneralRe: One little thing PinmemberSteve Marsh14-Oct-10 7:19 
GeneralControl tricks PinmemberNicolasG6-Oct-10 10:13 
GeneralRe: Control tricks PinmemberSteve Marsh14-Oct-10 7:18 
GeneralMy vote of 5 Pinmemberdave.kelly6-Oct-10 6:49 
GeneralVote of 5 PinmemberKelvin Armstrong5-Oct-10 22:01 
GeneralMy vote of 4 PinmemberSunil Soni4-Oct-10 21:50 
Generalthoughts PinmemberJoe Caffeine4-Oct-10 12:03 
GeneralRe: thoughts PinmemberSteveM45-Oct-10 8:36 

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

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

| Advertise | Privacy | Mobile
Web02 | 2.8.141022.2 | Last Updated 5 Apr 2013
Article Copyright 2010 by Steve Marsh
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid