Looking around for a theme-aware toggle button that could display text and an icon,
I could not find one, so
is the result: a pushbutton that can also be a toggle button,
and can display icon and/or text.
What's New in v1.3
In this version I have corrected (I believe) all the outstanding bugs
that have been reported (see list), and added several new features:
XButtonXP in Action
Here is what XButtonXP
looks like with themes:
|Icon on Left
||Icon on Right
And here is what XButtonXP looks like without themes:
|Icon on Left
||Icon on Right
XButtonXP can also be drawn using toolbar style:
CXButtonXP Implementation Notes
Normally, when you add
to exe, all controls used by exe will be displayed
as themed. However, this is not true of ownerdraw controls - the XP theming engine just ignores them.
Since I needed an ownerdraw button, it meant that XButtonXP
had to handle the XP theming support.
I created the
class to handle
and getting theme function pointers via
lightweight and easy to reuse, I designed it as singleton class, so that there is only one copy of
DLL's module handle and function pointers per process.
The first time that
is called, the theme is opened for
m_hTheme = ThemeHelper.OpenThemeData(m_hWnd, _T("Button"));
Aside from using theme functions for drawing the controls, one other thing
must do is handle
WM_THEMECHANGED message, which is
broadcast to every window following a theme change event:
m_hTheme = NULL;
m_bFirstTime = TRUE;
- BOOL IsAppThemed()
- BOOL IsThemeActive()
- BOOL IsThemeLibAvailable()
- BOOL CloseThemeData(HTHEME hTheme)
- BOOL DrawThemeBackground()
- BOOL DrawThemeParentBackground()
- BOOL DrawThemeText()
- BOOL GetThemeBackgroundContentRect()
- HTHEME OpenThemeData()
Controlling XButtonXP Theming
will use themes to draw button in the following circumstances:
The app is running on XP
Themes are enabled on system, and app has not been set to
"Disable visual themes" via Properties dialog:
Themes have not been disabled via
CXButtonXP Starting Point
I used Ewan Ward's article
Native Win32 Theme aware Owner-draw Controls without MFC
as starting point for XButtonXP
First, I adapted his code for MFC, and then used
to enable theme support.
The next step was to fix default button problem.
Default Button Problem
This problem plagues all ownerdraw buttons. Left uncorrected, it can give the visual appearance
that there are multiple default buttons on dialog, and improperly handles ENTER key.
describes this problem in detail, and has written very nice
class to transparently fix this problem for any ownerdraw button.
The final task was to ensure that SPACE and ENTER keys worked properly.
On standard pushbutton, these keys produce button-click event.
In order for XButtonXP
to handle them in same way, I had to intercept
message, and ask for all keys. At the same
time, I did not want to interfere with TAB key processing. The
message provides mechanism to do this, by returning
appropriate code. Then, I added handlers for
, to catch ENTER and SPACE
key presses. I converted these to
messages, to emulate mouse click.
Here are functions in
|CXButtonXP& EnableTheming(BOOL bEnable)
||Enable visual themes for button.
||Retrieve button custom background color (XBUTTONXP_NO_COLOR if none).
||Get toolbar style (TRUE = use toolbar style).
||Retrieve button custom text color (XBUTTONXP_NO_COLOR if none).
||Get toggle style (TRUE = button acts like toggle).
||Get toggle state (TRUE = button is pressed).
||Get theming state (TRUE = visual theme is being used).
|CXButtonXP& SetBackgroundColor(COLORREF rgb = XBUTTONXP_NO_COLOR)
||Set button custom background color. Default is XBUTTONXP_NO_COLOR.
|CXButtonXP& SetDrawToolbar(BOOL bDrawToolbar)
||Set toolbar style. Default is FALSE.
|CXButtonXP& SetIcon(UINT nIDResource, ICON_ALIGNMENT ia = LEFT)
||Set icon from resource id.
|CXButtonXP& SetIcon(HICON hIcon, ICON_ALIGNMENT ia = LEFT)
||Set icon from HICON.
|CXButtonXP& SetIconAlignment(ICON_ALIGNMENT ia)
||Set icon alignment on button. Default is LEFT.
|CXButtonXP& SetTextColor(COLORREF rgb = XBUTTONXP_NO_COLOR)
||Set button custom text color. Default is XBUTTONXP_NO_COLOR.
|CXButtonXP& SetToggle(BOOL bIsToggle)
||Set toggle style. Default is FALSE.
|CXButtonXP& SetToggleState(BOOL bToggled)
||Set toggle state. Default is FALSE.
How to use
CXButtonXP into your app, you first need to add following files to your project:
Next, include header file XButtonXP.h in appropriate project files
(typically the dialog header file).
Now you are ready to start using
The demo app shows how to call XButtonXP:
You can combine XButtonXP function calls like this:
Tips & Tricks
The button must not have
in dialog template.
When you include XButtonXP in your app, you might get error message
about the symbol
DFCS_HOT, even though you have installed
To fix this, you need to put this line in
stdafx.h, before any includes:
#define WINVER 0x0500
The compiler error message fatal error C1083: Cannot open include file: 'uxtheme.h': No such file or directory
means that compiler cannot find uxtheme.h, which is in Microsoft
Platform SDK. This is free download from Microsoft site.
I would give url here, but Microsoft keeps changing download page
for Platform SDK, so best thing is to
When custom colors are used for text or
background, theming is automatically switched off.
Version 1.3 - 2008 January 19
- Fixed bug when button is released and mouse is moved, reported by rootdial.
- Fixed problem with drawing as default button, reported by fredwobus and programbyran.
- Fixed resource leak in DrawIcon(), reported by grin.
- Fixed transparency bug for toolbar style, reported by Pandele Florin.
- Fixed bug where WM_COMMAND was being sent twice when return pressed, reported by fredwobus.
- Implemented WM_MOUSELEAVE handler, suggested by ksk, Roman Komary. fredwobus, 630596399 and EIEN.
- Added multi-line support, requested by jlatorref.
- Added grayscale support for disabled icon, requested by programbyran.
- Added support for custom text and background colors, requested by PatLeCat and Alex Evans.
- Added tooltips to demo.
- Added option to display message box to demo.
- Added option for hatch background to demo.
- Added option for different icon color formats to demo.
- Added option to select custom text and background colors to demo.
Version 1.2 - 2005 April 20
- Fixed bug with hot state, reported by ksk
- Added SetDrawToolbar() and GetDrawToolbar(), suggested by Dominik Reichl
Version 1.1 - 2005 March 30
- Fixed bug in drawing toggle button, reported by Dominik Reichl.
- Added SetToggleState()
#include "XButtonXPTest.h" from XButtonXP.cpp
Version 1.0 - 2005 March 22
This software is released under
The Code Project Open
License (CPOL). You are free to use this
software in any way you like, except that you may not sell this source code.
If you modify it or extend it, please to consider posting new code here for
everyone to share. This software is provided "as is" with no expressed or
implied warranty. I accept no liability for any damage or loss of business that
this software may cause.