Click here to Skip to main content
16,018,394 members
Articles / Desktop Programming / Windows Forms
Article

Windows Vista Aero Glass in .NET Managed Win32 Applications

Rate me:
Please Sign up or sign in to vote.
4.45/5 (30 votes)
18 Feb 20074 min read 198.1K   7.3K   78   23
Demonstrates the basics of using Aero Glass effects within a .NET managed Win32 Forms application.

Screenshot - AeroGlassForms.jpg

Introduction

There are a number of articles regarding the use of the Vista Aero APIs from within a managed Win32 Forms application. However having searched around, it seems several are outdated due to changes implemented between early Vista betas and Vista's final release.

This article is a brief introduction into the use of the new Vista APIs for extending the Aero Glass area into a managed Win32 application.

Background

So what is Aero? Aero is the new graphics UI for Vista. If you're lucky enough to own a copy of Vista and meet the hardware requirements, you can enable Aero through the Windows colour schemes dialog. This enables the Aero scheme on all Windows and dialogs (including Win32 applications), and provides translucent borders and blur effects known as Aero Glass.

As well as being aesthetically pleasing, Aero Glass can be used to enhance a user interface by controlling the focus of specific elements on screen. Remember according the Vista design guidelines the Glass effect should be used judiciously. It may be cool to do, but Glass is really intended for small regions without text or UI in order to make the interface appear more lightweight and clean.

Extending Glass

By default when Aero is enabled, all Windows have a translucent Glass frame and title bar. Using the Windows APIs it's possible to extend this Glass effect further into the client area. They can also be used to create Glass panels inside the client area, but unfortunately in managed code this is not as easy as it should be, and there are some major limitations.

To display Glass within a Window you must first use the DwmExtendFrameIntoClientArea API to extend Glass into the client area. Once this is done, any area within this region that is painted black will appear as a Glass surface. If the area is not painted, any Glass regions not hidden by controls will just appear black at runtime (rather than Glass). In previous beta versions of Vista this step did not appear necessary, which is why a lot of the samples in circulation do not appear to work.

Due the fact that Windows uses the colour black to mask out the Glass regions, this has an undesired effect on any Windows Form controls within the Glass area, including any black text which will be lost.

To get around this, it's best to use the drawing APIs to manually create any text and graphical elements within the Glass area, which will then allow the use of a black brush on the Glass surface. See Pang Wu's article for more detailed tutorials on these techniques (link below).

The Code

To use the Vista APIs we use a number of PInvoke methods defined as follows:

C#
[StructLayout(LayoutKind.Sequential)]
public struct MARGINS
{
    public int Left;
    public int Right;
    public int Top;
    public int Bottom;
}

[DllImport("dwmapi.dll", PreserveSig = false)]
public static extern void DwmExtendFrameIntoClientArea
                (IntPtr hwnd, ref MARGINS margins);

[DllImport("dwmapi.dll", PreserveSig = false)]
public static extern bool DwmIsCompositionEnabled();

We can now use these methods to ensure Aero effects are enabled, and then call DwmExtendFrameIntoClientArea to extend the Glass effect into the client area as follows. This only needs to be done once, so we can use the Forms OnLoad method to set up the desired Glass region.

C#
// defines how far we are extending the Glass margins
private MARGINS margins;

// uses PInvoke to setup the Glass area.
protected override void OnLoad(EventArgs e)
{
    base.OnLoad(e);
    if (DwmIsCompositionEnabled())
    {
        // Paint the glass effect.
        margins = new Win32.MARGINS();
        margins.Top = 20;
        margins.Left = 20;
        DwmExtendFrameIntoClientArea(this.Handle, ref margins);
    }
}

We now paint any areas we want to display as Glass with a black brush. This is best done by overriding the Form's OnPaintBackground method. There are several ways of doing this, to keep it simple we will first clear the background with a black brush to enable Glass in our defined region, and then repaint the non-Glass client area with it's original background colour.

C#
protected override void OnPaintBackground(PaintEventArgs e)
{
    base.OnPaint(e);
    if (DwmIsCompositionEnabled())
    {
        // paint background black to enable include glass regions
        e.Graphics.Clear(Color.Black);
        // revert the non-glass rectangle back to it's original colour
        Rectangle clientArea = new Rectangle(
                margins.Left,
                margins.Top,
                this.ClientRectangle.Width - margins.Left - margins.Right,
                this.ClientRectangle.Height - margins.Top - margins.Bottom
            );
        Brush b = new SolidBrush(this.BackColor);
        e.Graphics.FillRectangle(b, clientArea);
    }
}

In Summary

That concludes the basics of extending Glass into your managed Win32 client area, however there's a lot more to Aero, and this article barely scrapes the surface. With further API calls it's possible to turn the Glass blur effects on/off, or even define blurred shapes within the Glass panels. Luckily there are some great articles about taking this further, which cover detailed tutorials on adding text and graphics to your Glass panels. See further reading below for links.

In the future I hope to add more to this article, and investigate possible solutions for handling the colour masking required by the Glass regions.

History

  • Initial release: Feb 2007

Further Reading

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


Written By
Architect
United Kingdom United Kingdom
Mike Carlisle - Technical Architect with over 20 years experience in a wide range of technologies.

@TheCodeKing

Comments and Discussions

 
GeneralNice work! Pin
Tokinabo7-Jan-15 17:27
professionalTokinabo7-Jan-15 17:27 
Questionthe win32 Pin
C.CoderCreator16-Jun-12 21:23
C.CoderCreator16-Jun-12 21:23 
AnswerRe: the win32 Pin
Nicke Manarin25-Nov-13 4:54
Nicke Manarin25-Nov-13 4:54 
GeneralRe: the win32 Pin
TheCodeKing25-Nov-13 10:23
TheCodeKing25-Nov-13 10:23 
QuestionMARGINS definition Pin
theMadCoder1-Dec-11 5:34
theMadCoder1-Dec-11 5:34 
GeneralMy vote of 5 Pin
theMadCoder1-Dec-11 5:31
theMadCoder1-Dec-11 5:31 
GeneralGood Find! Pin
jp2code3-Jun-11 8:04
professionaljp2code3-Jun-11 8:04 
GeneralRe: Good Find! Pin
jp2code3-Jun-11 8:09
professionaljp2code3-Jun-11 8:09 
GeneralExtend the titlebar too Pin
AETCoder15-May-11 8:27
AETCoder15-May-11 8:27 
GeneralClean the brush! Pin
Vercas17-Dec-10 2:53
Vercas17-Dec-10 2:53 
QuestionBad text Pin
M62 11626-Aug-10 14:34
M62 11626-Aug-10 14:34 
GeneralRe: Bad text Pin
M62 11626-Aug-10 14:37
M62 11626-Aug-10 14:37 
AnswerRe: Bad text Pin
scasbyte23-May-12 20:20
scasbyte23-May-12 20:20 
QuestionForm clear not glass Pin
HaydenHaddock19-Apr-09 3:48
HaydenHaddock19-Apr-09 3:48 
AnswerRe: Form clear not glass Pin
TheCodeKing21-Apr-09 8:21
TheCodeKing21-Apr-09 8:21 
GeneralRe: Form clear not glass Pin
HaydenHaddock4-May-09 6:39
HaydenHaddock4-May-09 6:39 
AnswerFix to transparent control text Pin
Barry-Gigabyte18-Mar-09 6:42
Barry-Gigabyte18-Mar-09 6:42 
QuestionBad text in controls Pin
fher200718-Feb-07 23:26
fher200718-Feb-07 23:26 
AnswerRe: Bad text in controls Pin
TheCodeKing18-Feb-07 23:45
TheCodeKing18-Feb-07 23:45 
GeneralRe: Bad text in controls Pin
Robert Rohde19-Feb-07 0:04
Robert Rohde19-Feb-07 0:04 
GeneralRe: Bad text in controls Pin
TheCodeKing19-Feb-07 8:53
TheCodeKing19-Feb-07 8:53 
GeneralRe: Bad text in controls Pin
Chris_McGrath2-Jul-07 20:35
Chris_McGrath2-Jul-07 20:35 
AnswerRe: Bad text in controls Pin
James_Zhang25-Dec-08 17:48
James_Zhang25-Dec-08 17:48 

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.