Click here to Skip to main content
15,867,308 members
Articles / Multimedia / GDI+
Article

Fading Forms In and Out

Rate me:
Please Sign up or sign in to vote.
4.17/5 (15 votes)
13 Aug 2007CPOL2 min read 106.4K   1.3K   85   35
Add fade transitions to your applications
Screenshot - FadeForm.jpg

Introduction

Disclaimer: I am not the first to make a form fader, but I couldn't find one that did exactly what I wanted and so I created this.

I have had need in the past to cause my forms to perform fade transitions from one opacity to another. It was usually on load, close and window state changes. I finally decided to bring it all together in a nice, extendable Form. The FadeForm...

  • fades in on open.
  • fades out on close.
  • partially fades out on focus lost.
  • fades in on focus.
  • fades out on minimize.
  • fades in on restore.
  • must not annoy the user. :-) A form fader definitely has that potential.

Using the Code

To use FadeForm, just extend it instead of Form and you are ready to go.

C#
public class Form1 : FadeForm
{
     ...
}

It is defaulted to use the fade-in from nothing on open and out to nothing on close. It will also fade to 85% opacity when not the active window. You can set it to whatever you want, however.

C#
//This would set the form with its default values.
this.ActiveOpacity=1;
this.InactiveOpacity=.85;
this.MinimizedOpacity=0;

You may, from time to time, want to disable the fade effect.

C#
this.DisableFade(); //Turn off fade effects
this.EnableFadeDefaults(); //Turns on fade effects

You can also change the transition time.

C#
this.FadeTime=1; //1 sec transition

You can also do a one-time fade to any value.

C#
this.TargetOpacity=.25; //Fades the form to 25% opacity

Points of Interest

The opening and focus change events were easy to deal with. It was appropriate to use the built-in event listeners.

C#
public FadeForm()
{
    ...
    this.timer.Tick += new System.EventHandler(this.timer_Tick);
    
    this.Deactivate += new System.EventHandler(this.FadeForm_Deactivate);
    this.Activated += new System.EventHandler(this.FadeForm_Activated);
    this.Load += new System.EventHandler(this.FadeForm_Load);
}

private void FadeForm_Load(object sender, EventArgs e)
{
   this.Opacity = minimizedOpacity;
   this.TargetOpacity = activeOpacity;
}

private void FadeForm_Deactivate(object sender, EventArgs e)
{
    this.TargetOpacity = inactiveOpacity;
}

private void FadeForm_Activated(object sender, EventArgs e)
{
    this.TargetOpacity = activeOpacity;
}

The minimize and close events where a little trickier because the actions had to be postponed until the fade transition was complete. I had to override WndProc in order to catch the request for those actions and postpone the action until the transition was done.

C#
private const int WM_SYSCOMMAND = 0x112;
private const int WM_COMMAND = 0x111;
private const int SC_MINIMIZE = 0xF020;
private const int SC_RESTORE = 0xF120;
private const int SC_CLOSE = 0xF060; 

// Intercepts WindowMessages before they are processed.
protected override void WndProc(ref Message m)
{
    if (m.Msg==WM_SYSCOMMAND||m.Msg == WM_COMMAND) 
    {
        //Fade to zero on minimze
        if (m.WParam == (IntPtr)SC_MINIMIZE) 
        { 
            heldMessage = m;
            this.TargetOpacity = minimizedOpacity;
            return;
         }

         //Fade in if the window is restored from the taskbar
         else if (m.WParam == (IntPtr)SC_RESTORE 
           && this.WindowState == FormWindowState.Minimized) 
         { 
             base.WndProc(ref m);  
             this.TargetOpacity = activeOpacity;
             return;
         }

         //Fade out if the window is closed.
         else if (m.WParam == (IntPtr)SC_CLOSE) 
         { 
             heldMessage = m; 
             this.TargetOpacity = minimizedOpacity;
             return;
         }
     }
     base.WndProc(ref m);
}

Once that was done, all I had to do was perform the transitions.

C#
//Performs fade increment.
private void timer_Tick(object sender, EventArgs e)
{
    double fadeChangePerTick = timer.Interval * 1.0 / 1000 / fadeTime;

    //Check to see if it is time to stop the timer
    if (Math.Abs(targetOpacity - this.Opacity) < fadeChangePerTick)
    {
        //There is an ugly black flash if you set the Opacity to 1.0
        if (targetOpacity == 1) this.Opacity = .999;
        else this.Opacity = targetOpacity;
        
        //Process held Windows Message.
        base.WndProc(ref heldMessage);
        heldMessage = new Message();
        
        //Stop the timer to save processor.
        timer.Stop();
    }
    else if (targetOpacity > this.Opacity) this.Opacity += fadeChangePerTick;
    else if (targetOpacity < this.Opacity) this.Opacity -= fadeChangePerTick;
}

It is interesting to notice that the opacity is never actually 1. That was a hack on my part to keep the window from flashing black. I am not sure what the cause of this is, but the fix was easy, so I may never know.

You can see that I stop the timer after I reach my target opacity. You may wonder how it gets started. Every time I set TargetOpacity, the set method starts the timer. There's no sense running the timer and wasting processor power when you don't need it.

C#
private double TargetOpacity
{
    set
    {
        targetOpacity = value;
         if (!timer.Enabled) timer.Start();
    }
    get 
    { 
        return targetOpacity; 
    }
}

I think I made it about as easy as possible. I always like to adhere to the KISS principle: Keep it simple, stupid.

Thoughts

I plan to add a Notify(int n) method that will oscillate the opacity n times in order to get the user's attention. I also think it would be nice to give a choice between mouseover-based and focus-based transitions.

History

  • 13 August, 2007 -- Original version posted

License

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


Written By
Instructor / Trainer
United States United States
I am a mechanical engineer that works as a high school math teacher in Mulberry, Arkansas. I use programming as one way to keep my mind sharp.

Comments and Discussions

 
Generalblack flash Pin
roundy7215-Mar-09 9:23
roundy7215-Mar-09 9:23 
GeneralRe: black flash Pin
Nicholas Seward15-Mar-09 15:49
Nicholas Seward15-Mar-09 15:49 
GeneralRe: black flash Pin
Atanas Palavrov1-Apr-09 16:37
Atanas Palavrov1-Apr-09 16:37 
GeneralRe: black flash Pin
Atanas Palavrov12-May-09 9:14
Atanas Palavrov12-May-09 9:14 
GeneralRe: black flash [modified] Pin
Nicholas Seward12-May-09 10:13
Nicholas Seward12-May-09 10:13 
GeneralRe: black flash Pin
Atanas Palavrov14-May-09 3:54
Atanas Palavrov14-May-09 3:54 
GeneralRe: black flash Pin
Nicholas Seward14-May-09 5:49
Nicholas Seward14-May-09 5:49 
GeneralSystem ERROR Occured in Application Pin
coolpul6-Sep-08 2:50
coolpul6-Sep-08 2:50 
General.999 opacity and layout execution time Pin
nukefusion26-Nov-07 4:10
nukefusion26-Nov-07 4:10 
GeneralGeneral Comments Pin
Christopher Stratmann22-Aug-07 2:25
Christopher Stratmann22-Aug-07 2:25 
GeneralRe: General Comments Pin
Nicholas Seward26-Aug-07 7:05
Nicholas Seward26-Aug-07 7:05 
GeneralRe: General Comments Pin
Christopher Stratmann27-Aug-07 1:13
Christopher Stratmann27-Aug-07 1:13 
GeneralRe: General Comments Pin
Nicholas Seward27-Aug-07 4:46
Nicholas Seward27-Aug-07 4:46 
GeneralRe: General Comments Pin
Christopher Stratmann27-Aug-07 8:44
Christopher Stratmann27-Aug-07 8:44 
GeneralRe: General Comments Pin
Nicholas Seward27-Aug-07 10:25
Nicholas Seward27-Aug-07 10:25 
GeneralRe: General Comments Pin
Christopher Stratmann27-Aug-07 8:54
Christopher Stratmann27-Aug-07 8:54 
QuestionDoes it work with VB .Net ? Pin
Patrice Dargenton22-Aug-07 0:26
Patrice Dargenton22-Aug-07 0:26 
AnswerRe: Does it work with VB .Net ? Pin
Nicholas Seward26-Aug-07 6:58
Nicholas Seward26-Aug-07 6:58 
GeneralRe: Does it work with VB .Net ? Pin
Patrice Dargenton27-Aug-07 1:54
Patrice Dargenton27-Aug-07 1:54 
GeneralMDI child Pin
mcaos15-Aug-07 4:10
professionalmcaos15-Aug-07 4:10 
GeneralRe: MDI child Pin
Nicholas Seward16-Aug-07 14:42
Nicholas Seward16-Aug-07 14:42 
GeneralRe: MDI child Pin
mcaos16-Aug-07 21:56
professionalmcaos16-Aug-07 21:56 
GeneralCool... Pin
dgauerke13-Aug-07 8:41
dgauerke13-Aug-07 8:41 
GeneralRe: Cool... Pin
Nicholas Seward13-Aug-07 19:04
Nicholas Seward13-Aug-07 19:04 
GeneralRe: Cool... Pin
ddmccrory16-Aug-07 1:26
ddmccrory16-Aug-07 1:26 

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.