Click here to Skip to main content
11,639,178 members (64,671 online)
Click here to Skip to main content

FaderWnd - a Window Fader for Windows 2000

, 28 Jun 2000 145.8K 2.8K 54
Rate this:
Please Sign up or sign in to vote.
An MFC class to fade any window with only one line of code.
<!-- Link to source file download -->
  • Download source files - 4 Kb
  • <!-- Link to demo file download -->
  • Download demo project - 28 Kb
  • <!-- Article image -->

    Sample Image - FaderWnd.jpg

    <!-- Add the rest of your HTML here -->

    Introduction

    One of the attractive new features of Windows 2000 is the menu and other selections that fade away instead of just disappearing. To see this in operation you need to select "Use transition effects for menus and tooltips" on the "Effects" tab of the Display Properties dialog and then select "Fade effect" in the combo box.

    In this article I present a simple MFC class that allows you to apply a similar fading effect to any window you choose - with only one line of code! Don't just close a window - have it fade away! The effect is most appropriate to small windows; I use it most often for splash windows, about boxes and other small dialogs.

    To use the code you just add the FaderWnd source and header files to your MFC project, include the header in the relevant source file and construct a CFaderWnd when you want your window to fade. The CFaderWnd object itself takes care of fading your window and then destroying and deleting itself.

    The only code you need to write is new CFaderWnd(this). Once the CFaderWnd is constructed you can destroy or hide your window, or call EndDialog if the window is a modal dialog.

    For example, a modeless dialog (or it could be any child window):
    void CFadeTestDlg::OnClose() 
    {
    	new CFaderWnd(this);
    	DestroyWindow();
    }
    
    
    or a modal dialog:
    void CFadeTestDlg::OnOK() 
    {
    	if (UpdateData)
    	{
    		new CFaderWnd(this);
    		EndDialog(IDOK);
    	}
    }
    
    void CFadeTestDlg::OnCancel() 
    {
    	new CFaderWnd(this);
    	EndDialog(IDCANCEL);
    }
    

    How it works

    The CFaderWnd uses the new layered windows feature and the UpdateLayeredWindow API function. The constructor creates a new topmost window with the WS_EX_LAYERED style (among others) and with the same size and position as the source window (the window to be faded). It then uses UpdateLayeredWindow to fill the new window with a bitmap that is an exact copy of the source window. It also sets up a timer. When the constructor returns the source window can be destroyed (or hidden) and the new window remains visible.

    On each timer message CFaderWnd calls UpdateLayeredWindow again with a smaller value of alpha. Reducing the alpha value makes the window increasingly translucent. When alpha is at or very near zero CFaderWnd destroys the window and PostNcDestroy deletes the CFaderWnd object.

    The CFaderWnd constructor takes three parameters; it looks like this:

    CFaderWnd(CWnd *pWndToFade, UINT nFadeTime = 2000, BYTE byAlpha = 255);

    The second and third parameters are optional; the examples above all use the default values for these parameters. For obvious reasons (and if they're not obvious you shouldn't be reading this) the first parameter, which specifies the window to fade, must be supplied.

    CWnd *pWndToFade This is a pointer to the source window (the window to be faded).
    UINT nFadeTime This is a number of milliseconds for the whole duration of the fade. The default value gives a 2 second fade.
    BYTE byAlpha This is the alpha value at which to start the fade. The default value of 255 represents starting with a fully opaque window. You might choose to start at 127, for example, so that the window immediately becomes semi-transparent and then fades from there.

    UpdateLayeredWindow is only available on Windows 2000, so if the code were to call that function directly any program using the CFaderWnd class would fail to run on any other platform. I usually want my programs to run on any Win32 platform but to use the new features when they're available. Therefore the code does not call UpdateLayeredWindow directly. Instead it uses GetProcAddress to find out whether the function is available and calls it through the returned pointer when it is. If the function is not available CFaderWnd quietly deletes itself so it behaves as a no-op on older platforms. Thus you can use CFaderWnd in all your programs without compromising their ability to run on all Win32 platforms.

    License

    This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

    A list of licenses authors might use can be found here

    Share

    About the Author

    P J Pearson
    United Kingdom United Kingdom
    No Biography provided

    You may also be interested in...

    Comments and Discussions

     
    GeneralFader on Vista... Pin
    Paul Runner22-Dec-08 13:02
    memberPaul Runner22-Dec-08 13:02 
    GeneralRe: Fader on Vista... Pin
    Andrew Kulikov9-Feb-09 10:26
    memberAndrew Kulikov9-Feb-09 10:26 
    GeneralFading out a Splash Screen. Pin
    Nick Thomas21-Jul-06 1:45
    memberNick Thomas21-Jul-06 1:45 
    Hi,
    I got this to work OK for dialogs. I would like it to work with a splash screen. i.e. before the main window of my app starts.

    In the CFaderWnd constructor the AfxGetMainWnd() returns not with the main window CWnd* but with the same CWnd* as the window to be faded. I think this is screwing it up.
    When this happens it jumps straight to the destructor of CFaderWnd and no fading takes place.

    Any suggestions?
    GeneralRe: Fading out a Splash Screen. Pin
    Phil J Pearson21-Jul-06 9:01
    memberPhil J Pearson21-Jul-06 9:01 
    QuestionUpdateLayeredWindow on extended desktops? Pin
    lamagaaya8-Mar-06 6:35
    memberlamagaaya8-Mar-06 6:35 
    AnswerRe: UpdateLayeredWindow on extended desktops? Pin
    b@andreasen8.org25-Sep-06 8:32
    memberb@andreasen8.org25-Sep-06 8:32 
    GeneralRe: UpdateLayeredWindow on extended desktops? Pin
    lamagaaya26-Sep-06 16:11
    memberlamagaaya26-Sep-06 16:11 
    GeneralInvalid access to memory location. Pin
    iampams1-Nov-05 19:12
    memberiampams1-Nov-05 19:12 
    AnswerRe: Invalid access to memory location. Pin
    Phil J Pearson2-Nov-05 8:59
    memberPhil J Pearson2-Nov-05 8:59 
    GeneralLayered Windows API Pin
    Zero DeHero14-May-03 0:08
    memberZero DeHero14-May-03 0:08 
    QuestionDivide by zero? Pin
    msvcpp17-Mar-03 1:21
    membermsvcpp17-Mar-03 1:21 
    GeneralSmall memory leak Pin
    Corey A16-Jan-03 4:36
    memberCorey A16-Jan-03 4:36 
    Generallayerd window on 9x Pin
    kuzi6-Mar-02 5:46
    memberkuzi6-Mar-02 5:46 
    GeneralRe: layerd window on 9x Pin
    Phil J Pearson6-Mar-02 10:04
    memberPhil J Pearson6-Mar-02 10:04 
    QuestionHelp with Alpha Blending? Pin
    swinefeaster30-Jan-02 10:41
    memberswinefeaster30-Jan-02 10:41 
    GeneralA question of "FaderWnd"Class from China. Pin
    Sailing11-Oct-01 3:43
    memberSailing11-Oct-01 3:43 
    GeneralDoes'nt work with maximized windows Pin
    Anonymous6-Sep-01 2:33
    memberAnonymous6-Sep-01 2:33 
    GeneralGreat + Small Suggestion Pin
    DanG20-Aug-01 23:13
    memberDanG20-Aug-01 23:13 
    Questionhow can i use on winnt?? are you know it? Pin
    what?26-Jul-00 21:07
    susswhat?26-Jul-00 21:07 
    AnswerRe: how can i use on winnt?? are you know it? Pin
    ChangYoung Jung16-Sep-00 18:28
    sussChangYoung Jung16-Sep-00 18:28 
    GeneralExplain of code in lame Pin
    Adun13-Jul-00 10:35
    sussAdun13-Jul-00 10:35 
    GeneralRe: Explain of code in lame Pin
    Romout8-Sep-01 2:10
    memberRomout8-Sep-01 2:10 
    GeneralRe: Explain of code in lame Pin
    Romout8-Sep-01 2:10
    memberRomout8-Sep-01 2:10 
    GeneralRe: Explain of code in lame Pin
    Phil J Pearson10-Sep-01 10:52
    memberPhil J Pearson10-Sep-01 10:52 
    GeneralComments Pin
    Rui Lopes24-Jun-00 0:51
    sussRui Lopes24-Jun-00 0:51 
    GeneralRe: Comments Pin
    Phil24-Jun-00 9:09
    sussPhil24-Jun-00 9:09 
    GeneralRe: Comments Pin
    Mike Dunn29-Jun-00 0:22
    sussMike Dunn29-Jun-00 0:22 
    GeneralGood! Pin
    Joe23-Jun-00 10:00
    sussJoe23-Jun-00 10:00 

    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 | Terms of Use | Mobile
    Web04 | 2.8.150728.1 | Last Updated 29 Jun 2000
    Article Copyright 2000 by P J Pearson
    Everything else Copyright © CodeProject, 1999-2015
    Layout: fixed | fluid