Click here to Skip to main content
15,880,427 members
Articles / Programming Languages / C#
Article

Themed RichTextBox - A RichTextBox with XP-styled borders

Rate me:
Please Sign up or sign in to vote.
4.42/5 (16 votes)
11 Oct 2006CPOL3 min read 152.7K   1.5K   53   41
An article about XP-theming.

Sample Image

Contents

  1. Introduction
  2. Background
  3. Where to draw the border
  4. The implementation in C#
    1. Filter some Windows messages
    2. Find out if you should render with XP styles
    3. Get the device context of the window frame
    4. Draw the border using uxTheme.dll
  5. Points of interests
  6. History

1. Introduction

In this article, I will show you how to apply XP-styles to a RichTextBox. The only thing I do here is to derive from the RichTextBox and add support for XP-themed border style. The control is able to run on .NET 1.1 and .NET 2.0.

2. Background

Visual Styles are not fully supported in NET 1.1. There is a bug in the Application.EnableVisualStyles method, and some controls do not render the XP-styles correctly. Here is a good overview about what is going wrong in NET 1.1: VisualStyles. But now we have NET 2.0 and all these bugs are fixed, and nearly all controls render with XP-styles. The only exception is the RichTextBox control. So I decided to write this article.

3. Where to draw the border

Normally, in NET, all paintings are done in the OnPaint or OnPaintBackground methods of a control. The problem is, inside these methods, you always draw to the client area (ClientRectangle) of a control. However, the borders are drawn outside this area in the window frame that should be drawn during the WM_NCPAINT message. For a better understanding, look at this illustration...

windows frames

4. The implementation in C#

4.1 Filter some Windows messages in the RichTextBox

When we customize the window frame, we must filter some messages and process them.

  1. WM_NCPAINT message tells us that the border should be redrawn.
  2. WM_NCCALCSIZE message tells us that the client area should be calculated.
C#
/// <summary>
/// Filter some message we need to draw the border.
/// </summary>
protected override void WndProc(ref Message m)
{
    switch(m.Msg)
    {
        case NativeMethods.WM_NCPAINT:
        // the border painting is done here.
            WmNcpaint(ref m);
            break;
        case NativeMethods.WM_NCCALCSIZE:
        // the size of the client area is calcuated here.
            WmNccalcsize(ref m);
            break;
        default:
            base.WndProc (ref m);
            break;
    }
}

4.2 Find out if you should render with XP styles

To find out if we should render an application with visual styles, is not an easy task. There are three things to consider.

  1. Check if the OS supports XP-styles. Windows XP or above supports theming.
  2. Check if XP-styles are activated in the current environment.
  3. Check if XP-styles are enabled for the current application.

After Googling around in the web, I found a method that does the job: IsVisualStylesEnabled Revisited.

4.3 Get the device context of the window frame

To draw in the window frame, we need some Win32-APIs to get the corresponding device context (DC).

  1. GetWindowDC to get the device context of the window frame.
  2. GetWindowRect to get the rectangle of the window frame.
  3. ExcludeClipRect to exclude the client area of the window frame.
  4. ReleaseDC to release the DC.

Here are the declarations in C#:

C#
[DllImport("user32.dll")]
public static extern IntPtr GetWindowDC(IntPtr hWnd);

[DllImport("user32.dll")]
public static extern int ReleaseDC(IntPtr hWnd, IntPtr hDC);

[DllImport("user32.dll")]
public static extern bool GetWindowRect(IntPtr hWnd, out RECT lpRect);

[DllImport("gdi32.dll")]
public static extern int ExcludeClipRect(IntPtr hdc, 
       int nLeftRect, int nTopRect, int nRightRect, int nBottomRect);

4.4 Draw the border using uxTheme.dll

Drawing visual styles is provided through the uxTheme.dll. We only need a few functions to draw the border.

  1. OpenThemeData to get a theme handle.
  2. GetThemeBackgroundContentRect to retrieve the size of the border.
  3. DrawThemeBackground draws the border.
  4. CloseThemeData releases the theme handle.

Here are the declarations in C#.

C#
[DllImport("uxtheme.dll", ExactSpelling=true, CharSet=CharSet.Unicode)]
public static extern IntPtr 
       OpenThemeData(IntPtr hWnd, String classList);

[DllImport("uxtheme", ExactSpelling=true)]
public extern static Int32 GetThemeBackgroundContentRect(IntPtr hTheme, 
       IntPtr hdc, int iPartId, int iStateId, 
       ref RECT pBoundingRect, out RECT pContentRect);

[DllImport("uxtheme", ExactSpelling=true)]
public extern static Int32 DrawThemeBackground(IntPtr hTheme, 
       IntPtr hdc, int iPartId, int iStateId, 
       ref RECT pRect, IntPtr pClipRect);

[DllImport("uxtheme.dll", ExactSpelling=true)]
public extern static Int32 CloseThemeData(IntPtr hTheme);

5. Points of interests

The .NET Framework 2.0 contains new classes for drawing visual styles. You can find them in the System.Windows.Forms.VisualStyles namespace. Also a method to check, if visual styles are enabled, is available in the new framework. Look for the Application.RenderWithVisualStyles property. However, I had not made two versions, because I think having one version for both is less to do on modifications and thus the better solution.

6. History

  • 11-10-2006 - Bug fix: Themed border disappears after MultiLine is set to false.
  • 17-07-2006 - Bug fix: Problem when mixing NET Framework versions.
  • 07-04-2006 - First release.

License

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


Written By
Software Developer (Senior) bemento
Germany Germany
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
GeneralTheme richedit control using Visual Style Pin
dbstudio4-Oct-10 0:18
dbstudio4-Oct-10 0:18 
GeneralRe: Theme richedit control using Visual Style Pin
Bernhard Elbl4-Oct-10 0:29
Bernhard Elbl4-Oct-10 0:29 
GeneralRe: Theme richedit control using Visual Style Pin
dbstudio4-Oct-10 5:56
dbstudio4-Oct-10 5:56 
Questionhow can i use your method for xp-styled commnadbutton? Pin
gaojb20-Dec-09 21:01
gaojb20-Dec-09 21:01 
AnswerRe: how can i use your method for xp-styled commnadbutton? Pin
Bernhard Elbl23-Dec-09 2:17
Bernhard Elbl23-Dec-09 2:17 
GeneralRe: how can i use your method for xp-styled commnadbutton? Pin
gaojb26-Dec-09 3:14
gaojb26-Dec-09 3:14 
GeneralGreat control but... Pin
Steve H. (UK)29-Nov-07 23:52
Steve H. (UK)29-Nov-07 23:52 
GeneralRe: Great control but... Pin
Bernhard Elbl30-Nov-07 5:11
Bernhard Elbl30-Nov-07 5:11 
GeneralAnother way, easier, but uglier [modified] Pin
mjelten19-Jul-07 22:44
mjelten19-Jul-07 22:44 
GeneralRe: Another way, easier, but uglier Pin
Bernhard Elbl23-Jul-07 19:45
Bernhard Elbl23-Jul-07 19:45 
GeneralRe: Another way, easier, but uglier Pin
IssaharNoam30-Oct-07 22:38
IssaharNoam30-Oct-07 22:38 
GeneralHey Pin
Shin-Ra29-Mar-07 17:51
Shin-Ra29-Mar-07 17:51 
GeneralSimplified VB .Net 2.0 Version Pin
Giles Bathgate10-Feb-07 0:10
Giles Bathgate10-Feb-07 0:10 
GeneralRe: Simplified VB .Net 2.0 Version [modified] Pin
Bernhard Elbl10-Feb-07 6:10
Bernhard Elbl10-Feb-07 6:10 
GeneralRe: Simplified VB .Net 2.0 Version [modified] Pin
Giles Bathgate23-Jul-07 5:48
Giles Bathgate23-Jul-07 5:48 
General.NET 2.0 Pin
stax769-Feb-07 12:25
stax769-Feb-07 12:25 
QuestionMultiline change the border? Pin
pserranop4-Oct-06 4:51
pserranop4-Oct-06 4:51 
AnswerRe: Multiline change the border? Pin
Bernhard Elbl5-Oct-06 22:18
Bernhard Elbl5-Oct-06 22:18 
GeneralRe: Multiline change the border? Pin
pserranop5-Oct-06 23:18
pserranop5-Oct-06 23:18 
GeneralRe: Multiline change the border? Pin
Bernhard Elbl6-Oct-06 2:37
Bernhard Elbl6-Oct-06 2:37 
GeneralRe: Multiline change the border? Pin
pserranop8-Oct-06 21:25
pserranop8-Oct-06 21:25 
GeneralRe: Multiline change the border? Pin
Bernhard Elbl12-Oct-06 5:43
Bernhard Elbl12-Oct-06 5:43 
GeneralTried to apply same to UserControl but didn't work Pin
SerialHobbyist23-Sep-06 8:52
SerialHobbyist23-Sep-06 8:52 
GeneralRe: Tried to apply same to UserControl but didn't work Pin
Bernhard Elbl2-Oct-06 5:17
Bernhard Elbl2-Oct-06 5:17 
QuestionRe: Tried to apply same to UserControl but didn't work Pin
Simon P Stevens14-Nov-06 2:55
Simon P Stevens14-Nov-06 2:55 

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.