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

Themed RichTextBox - A RichTextBox with XP-styled borders

, 11 Oct 2006 CPOL
Rate this:
Please Sign up or sign in to vote.
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.
/// <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#:

[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#.

[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)

Share

About the Author

Bernhard Elbl
Software Developer (Senior) bemento
Germany Germany
No Biography provided

Comments and Discussions

 
GeneralTheme richedit control using Visual Style Pinmemberdbstudio4-Oct-10 1:18 
GeneralRe: Theme richedit control using Visual Style PinmemberBernhard Elbl4-Oct-10 1:29 
GeneralRe: Theme richedit control using Visual Style Pinmemberdbstudio4-Oct-10 6:56 
Questionhow can i use your method for xp-styled commnadbutton? Pinmembergaojb20-Dec-09 22:01 
AnswerRe: how can i use your method for xp-styled commnadbutton? PinmemberBernhard Elbl23-Dec-09 3:17 
GeneralRe: how can i use your method for xp-styled commnadbutton? Pinmembergaojb26-Dec-09 4:14 
GeneralGreat control but... PinmemberSteve H. (UK)30-Nov-07 0:52 
GeneralRe: Great control but... PinmemberBernhard Elbl30-Nov-07 6:11 
GeneralAnother way, easier, but uglier [modified] Pinmembermjelten19-Jul-07 23:44 
GeneralRe: Another way, easier, but uglier PinmemberBernhard Elbl23-Jul-07 20:45 
GeneralRe: Another way, easier, but uglier PinmemberIssaharNoam30-Oct-07 23:38 
GeneralHey PinmemberShin-Ra29-Mar-07 18:51 
GeneralSimplified VB .Net 2.0 Version PinmemberGilesb10-Feb-07 1:10 
GeneralRe: Simplified VB .Net 2.0 Version [modified] PinmemberBernhard Elbl10-Feb-07 7:10 
GeneralRe: Simplified VB .Net 2.0 Version [modified] PinmemberGilesb23-Jul-07 6:48 
General.NET 2.0 Pinmemberstax07119-Feb-07 13:25 
QuestionMultiline change the border? Pinmemberpserranop4-Oct-06 5:51 
AnswerRe: Multiline change the border? PinmemberBernhard Elbl5-Oct-06 23:18 
GeneralRe: Multiline change the border? Pinmemberpserranop6-Oct-06 0:18 
GeneralRe: Multiline change the border? PinmemberBernhard Elbl6-Oct-06 3:37 
GeneralRe: Multiline change the border? Pinmemberpserranop8-Oct-06 22:25 
GeneralRe: Multiline change the border? PinmemberBernhard Elbl12-Oct-06 6:43 
GeneralTried to apply same to UserControl but didn't work PinmemberSerialHobbyist23-Sep-06 9:52 
GeneralRe: Tried to apply same to UserControl but didn't work PinmemberBernhard Elbl2-Oct-06 6:17 
QuestionRe: Tried to apply same to UserControl but didn't work PinmemberSimonStevens14-Nov-06 3:55 

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
Web03 | 2.8.141220.1 | Last Updated 11 Oct 2006
Article Copyright 2006 by Bernhard Elbl
Everything else Copyright © CodeProject, 1999-2014
Layout: fixed | fluid