CxShadeButton

• Download source files - 16 Kb
• Download demo project - 45 Kb

Introduction

With this class you can easily give a professional look to your buttons in few steps. No bitmap resources are needed - all bitmaps are generated at runtime. Parts of the code come from the CxSkinButton article.
The goal is to replace the standard buttons, check boxes and radio buttons with minimal modifications in the application code.

1. Add "xShadeButton.cpp" and "xShadeButton.h" to the project.
   
2. Include "xShadeButton.h" in the header file where the controls are defined
   
3. Create (or edit) a member variable for each button you want to customize as CxShadeButton. If the Class Wizard doesn't show the CxShadeButton type, select CButton and then edit the code manually.
   
4. In the window initialization add the CxShadeButton methods:

   BOOL CxShadeButtonDemoDlg::OnInitDialog()
   {
   	//	...
   
   	m_btn1.SetTextColor(RGB(255,0,0));
   	m_btn1.SetToolTipText("Button1");
   	m_btn1.SetShade(SHS_DIAGSHADE,8,10,5,RGB(55,255,55));
   //	...
   
   

CxShadeButton Class Members & Operations

CxShadeButton is derived from CButton. The BS_OWNERDRAW style is added automatically, you don't need to set the "Owner draw" property in the resource editor. You can change some styles (flat, push-like, text alignment, group,...) using the resource editor, however not all the styles are currently supported.
If you change the aspect of the button at runtime, to avoid flicker first call the functions that don't cause invalidation (like SetShade, SetIcon or SetFont) and than invalidate the button, for example with SetWindowText, or directly with Invalidate.

void SetShade(UINT shadeID=0, BYTE granularity=8,
              BYTE highlight=10,BYTE coloring=0,COLORREF color=0);

Generates the button bitmaps.

Important

• shadeID : can be one of these effects:
  SHS_NOISE = 0
SHS_DIAGSHADE = 1
SHS_HSHADE = 2
SHS_VSHADE = 3
SHS_HBUMP = 4
SHS_VBUMP = 5
SHS_SOFTBUMP =6
SHS_HARDBUMP = 7
SHS_METAL = 8

• granularity : this parameter add an uniform noise to the button bitmaps. A good value is from 5 to 20; 0 to disable the effect. The noise has a positive effect because it hides the palette steps.
• highlight : sets the highlight level when the mouse is over the button. A good value is from 5 to 20; 0 to disable the effect.
• coloring : sets the percentage of color to blend in the button palette. The value can range from 0 to 100; 0 to disable the effect.
• color : if coloring is greater than zero, color is mixed with the standard button colors.

  Remarks : the coloring and color parameter should be used carefully to guarantee a good aspect in all the situations.

void SetToolTipText(CString s, CString sDown="");

Sets or changes the tool tip text.

nice

• s: String displayed in normal state.
• sDown: (optional) Specifies a second text to be displayed when a check box or radio button is checked.

COLORREF SetTextColor(COLORREF new_color);

Sets or changes the button text color. Returns the previous button text color.

nice

void SetIcon(UINT nIcon, UINT nIconAlign=BS_CENTER, UINT nIconDown=0, 
             UINT nIconHighLight=0);

Similar to the BS_ICON style.

nice

• nIcon : ID number of the icon resource
  
• nIconAlign : icon alignment, can be one of the following values:
  BS_CENTER
BS_LEFT
BS_RIGHT
• nIconDown : (optional) ID number of the icon resource displayed when the button is checked.
• nIconHighLight : (optional) ID number of the icon resource displayed when the mouse pointer is over the button.

  Remarks : the button text is automatically placed so that the icon and the text don't overlap.

bool SetFont(CString sFontName, long lSize=0, long 
             lWeight=400, BYTE bItalic=0, BYTE bUnderline=0);
bool SetFont(LOGFONT* pNewStyle); / LOGFONT* GetFont();

Changes the text font.

nice

• sFontName : specifies the typeface name of the font.
  
• lSize : (optional) text height
  
• lWeight : (optional) text weight can range from 0 to 1000; 100=thin, 300=light, 400=normal, 700=bold
• bItalic : (optional) italic style
  
• bUnderline : (optional) underline style
  

  Remarks : use GetFont/SetFont with a LOGFONT structure to get/set the complete attributes of the font. GetFont returns NULL if the button is using the default system font.

void SetTextAlign(UINT nTextAlign=BS_CENTER);

nTextAlign : button text alignment, can be one of the following values:

optional

BS_CENTER
BS_LEFT
BS_RIGHT

void SetFlat(bool bFlag);

bFlag : sets the border style:

optional

FALSE = standard 3D border.
TRUE = flat border.

Release History

v1.00 - 12/05/2001
- basic implementation and interface.
v1.10 - 23/05/2001
- added text shift on button down.
- fixed many CxDib bugs.
- fixed SHS_HARDBUMP bug.
- added icon support.
- added text alignment.
- added flat style.
v1.20 - 23/06/2001
- fixed keyboard shortcut bug.
- check box & radio button add on.
- 2nd icon & 2nd tooltip add on.
- memory DC for painting operations.
v1.30 - 03/08/2001
- fixed SetIcon bug.
- added Font support.
v1.40 - 23/09/2001
- fixed memory leakage bug in DrawItem() and SetIcon().
- fixed second tooltip initialization bug.
- fixed OnLButtonUp() problem with drag & drop.
- added multiline tooltip support.
v1.41 - 4/11/2001
- fixed memory leakage bug in SetIcon() and in the destructor.
- added 3rd icon for highlighted state.

Compatibility

Win95,WinNT = Yes, requires IE3.0 or higher
Win98, WinME, W2K, WinXP = Yes

For any questions, e-mail to: ing.davide.pizzolato@libero.it

Thanks to all the Code Project developers!
Special thanks to:
Milan Gardian for mouse and keyboard tracking code.
Davide Calabro for CButtonST code snippets.
Rainer Mangold for radio-button and check-box code.
Jeremy Davis, Andre Brogli, Richard Cunday, Shanker Chandrabose, Luis,
Gilad, Rui Lopes, Tom Archer, Tommy Svensson, David Scambler,
Orioli Alessandro, João Filipe de Castro Ferreira, Jesper Kinnås, Derek Lakin for suggestions, debugging & support.

You must Sign In to use this message board.

FAQ  Noise Tolerance Very HighHighMediumLowVery Low  Search Messages    Layout Expand All MessagesThread ViewNo Javascript (slow)No Javascript Preview    Per page 102550

Msgs 1 to 25 of 78 (Total in Forum: 78) (Refresh) FirstPrevNext

Very nicely done! Doug Knudson 2:56 11 Jun '04   Davide, Really nice job on this control! Thanks, Doug Doug Knudson Sign In·View Thread·PermaLink Help on this button in DLLs Sreekanth Muralidharan 18:21 12 Oct '05   Hello I am a user of this button in a project. The button was behaving well till we decided to put this as a reusable tool in a DLL. Everything went hap hazard after that. It is definitely not the problem with CxShadeButton but the way the DLL is linked. Could any one of you give a guidance on this bug in MFC? Regards Sreekanth Muralidharan Hyderabad INDIA Sreekanth Muralidharan, Corporate Systems Consultant [Embedded Systems], INDIA Sign In·View Thread·PermaLink Re: Help on this button in DLLs deepakgupta111 1:16 13 Feb '06   I believe that the DLL is not getting a call to its PreTranslateMessages, for this purpose create a function in DLL to call the PreTranslateMessages, Export this function from the DLL, then call PreTranslateMssages handler from the PreTranslateMessages of EXE, see example below /*************************************************/ // export the function - put in DLL's header file extern "C" BOOL HandlePreTranslateMessages(MSG* pMsg); /*************************************************/ // put in DLL's source file extern "C" BOOL HandlePreTranslateMessages(MSG* pMsg) { AFX_MANAGE_STATE(AfxGetStaticModuleState()); return theApp.PreTranslateMessage(pMsg); } /*************************************************/ //call the above function from the EXE's PreTranslateMessage Function BOOL CMainView::PreTranslateMessage(MSG* pMsg) { BOOL bRetVal ; typedef BOOL (*HandlePreTranslateMessagesHandler)(MSG*); HandlePreTranslateMessagesHandler HandlePreTranslateMessages; HandlePreTranslateMessages= (HandlePreTranslateMessages) GetProcAddress(hInstLib /*Instance of DLL obtained Separately*/, "HandlePreTranslateMessages"); if(HandlePreTranslateMessages!=NULL) { bRetVal = HandlePreTranslateMessages(pMsg); } return CView::PreTranslateMessage(pMsg); } /*************************************************/ Deepak Gupta Compro technologies Sign In·View Thread·PermaLink Disabled state of radio buttons Bijawara N Krishnaswamy 20:43 23 May '04   If the radio button is in disabled state,even though its selected, radio button will be in unselected state. is this a bug ? If not how to solve this problem... Thanx in advance Sign In·View Thread·PermaLink 2.00/5 (1 vote) Blinking buttons? Josiemaran 20:57 6 Apr '04   hihi, anyone knows how to make the button blink and change color at e same time?? Sign In·View Thread·PermaLink 2.33/5 (2 votes) correct shade combination Josiemaran 17:20 28 Mar '04   Hi, anyone knows how to set the button shade to the one shown on the article? as you all know, if you download the source and jus set it, the shade is not as nice as the ones shown. so wats the shade combination to make it so nice?? Sign In·View Thread·PermaLink Apply CxShadeButton to MessageBox MickeyJC 9:59 19 Nov '03   I tried it and I liked it. Thanks for sharing. Question: How to replace OK or Cancel buttons with CxShadeButton in a MessageBox ? Sign In·View Thread·PermaLink 2.00/5 (1 vote) Re: Apply CxShadeButton to MessageBox Davide Pizzolato 14:04 19 Nov '03   thanks Answer: you need a member variable for each button and replace CButton with CxShadeButton. A working example is in the demo for my CxImage article, where I use CxTargetButton in every dialog, but the principle is the same. Sign In·View Thread·PermaLink Bitmaps on Buttons AntonDel 7:36 3 Oct '03   Pretty cool and easy class to use! Regarding your explanation: "No bitmap resources are needed - all bitmaps are generated at runtime. Parts of the code come from the CxSkinButton article." Is there any example? I can't get something like: CxShadeButton mBut; mbut.SetBitmap("myBitmap.bmp"); How can i do it? Congratulations, Toni Sign In·View Thread·PermaLink Re: Bitmaps on Buttons Davide Pizzolato 23:13 3 Oct '03   http://www.codeproject.com/buttonctrl/cbuttonst.asp already have this feature. Or you can look for "m_Icon" in the source code and replace HICON with HBITMAP, after that with some adjustment you can make it work. Sign In·View Thread·PermaLink Some problems with using SetIcon lijd75 4:40 24 Mar '03   CxShadeButton is a very useful class, very thank you to write this class. I encounter some problems when I use CxShadeButton. May you help me? . I am not able to load icon with setIcon()( but sometimes Seticon work well). Please give some likelihood causes. your sincerely. my email: Lijd75@tom.com . ljd -- modified at 1:02 Friday 7th April, 2006 Sign In·View Thread·PermaLink Combination Shaded and Round Buttons? WGC 4:42 28 Feb '03   Hello, Davide - I've been searching for a class that would give me round, shaded buttons (to simulate lit/unlit pushbuttons larger than LEDs), and have come across your article on the CxShadeButton class (which looks really cool!) and another, CRoundButtons by Chris Maunder (also a CodeProject submission). Here is my question: Can these two classes be combined in some fashion in order to produce this effect? Basically, I'm trying to create the illusion of a hemispherical button, approx 34 pixels in diameter, that looks lit when enabled and off (and slightly inset) when disabled. I figured I could use a bright red shading for on, darker red for off, etc. As a neophyte windows programmer how would I get this accomplished? Is something like this even possible? Well, "anything" is possible, but how feasible is it? Most of my 20+ years programming has been in the DOS, structured programming world: MFC is growing on me, but I'm nowhere near proficient yet in this environment! Many thanks! Will Cummings PS - I just noticed your article on SkinButtons - but I don't have a means to easily create shaded bitmaps (MSPaint is a pain!) - hence my desire to use your shading algorithms to have the computer do the painting.... Thanks! Sign In·View Thread·PermaLink 2.00/5 (1 vote) Static Linking Anonymous 3:32 5 Feb '03   When I set the compiler to statically link to MFC it crashes. Any idea why? Sign In·View Thread·PermaLink Re: Static Linking Davide Pizzolato 9:08 5 Feb '03   on my PC, static MFC link works Sign In·View Thread·PermaLink DoubleClick on Checkbox not working Jack_pt 18:13 22 Nov '02   My program was set up to handle a doubleclick on a checkbox. I changed the declaration from CButton to CxShadeButton and now it doesn't recognize doubleclicks. Everything else seems to work (change font, color). Does your class recognize doubleclicks? Is there something else I am supposed to do to handle them? Jack Sign In·View Thread·PermaLink Re: DoubleClick on Checkbox not working Davide Pizzolato 2:45 23 Nov '02   Simply remove the CxShadeButton::OnLButtonDblClk handler, this should solve the problem. Sign In·View Thread·PermaLink Re: DoubleClick on Checkbox not working Jack_pt 3:40 23 Nov '02   That did it. Thanks. And, once again, excellent job. Sign In·View Thread·PermaLink Re: DoubleClick on Checkbox not working sky_tiger_2004 6:07 23 Oct '05   I'm testing. terible sorry Sign In·View Thread·PermaLink No DDX_Radio support Gezo 4:40 14 Oct '02   Very nice work, indeed. But I run on DDX_Radio problem. This function gets crushed when I call UpdateData(TRUE) . It's really handy to have some int take care of position in radio group. I solve first ASSERT in DDX_Radio: ASSERT(::SendMessage(hWndCtrl, WM_GETDLGCODE, 0, 0L) & DLGC_RADIOBUTTON); by adding ON_WM_GETDLGCODE() to CxShadeButton class. But the porgram also asserts at ASSERT(value == -1); in DDX_Radio function because he finds two radio buttons with state clicked. Please help me. Sign In·View Thread·PermaLink Re: No DDX_Radio support Davide Pizzolato 20:38 14 Oct '02   Please, check the implementation in http://www.codeproject.com/buttonctrl/cbuttonst.asp[^] Sign In·View Thread·PermaLink Re: No DDX_Radio support deepakgupta111 5:50 14 May '03   I have the same problem, it is solved by writing a message handler function for BM_GETCHECK message, like this ON_MESSAGE(BM_GETCHECK,OnGetCheckRadioButton) LRESULT CXPRadioButton::OnGetCheckRadioButton(WPARAM wParam, LPARAM lParam) { /* m_nState is to keep the track of state of radio button * which you have to do yourself * m_nState ==1 means radio button selected and m_nstate ==0 * means radio button unselected */ return m_nState; } Deepak Gupta Compro technologies Sign In·View Thread·PermaLink Really Like The Shades..How to apply to Dialog face?? Mustafa 8:07 24 May '02   Hi... Great job....really like it How to apply these shades on dialog face?? e.g to make the dialog background to have the metal look?? Thanks Mustafa Sign In·View Thread·PermaLink 1.50/5 (2 votes) Problems!! Yasmin 13:32 22 Mar '02   I want to use this class, but when I tried to run my example project I only can to see a lot or mistakes (50) inside CxShadeButton.cpp. What can I do? C:\templ\prueba\xShadeButton.h(145) : error C2079: 'm_tooltip' uses undefined class 'CToolTipCtrl' pruebaDlg.cpp C:\templ\prueba\xShadeButton.h(145) : error C2079: 'm_tooltip' uses undefined class 'CToolTipCtrl' xShadeButton.cpp C:\templ\prueba\xShadeButton.h(145) : error C2079: 'm_tooltip' uses undefined class 'CToolTipCtrl' C:\templ\prueba\xShadeButton.cpp(139) : error C2065: 'SetStretchBltMode' : undeclared identifier C:\templ\prueba\xShadeButton.cpp(139) : error C2065: 'COLORONCOLOR' : undeclared identifier C:\templ\prueba\xShadeButton.cpp(140) : error C2065: 'SetDIBitsToDevice' : undeclared identifier C:\templ\prueba\xShadeButton.cpp(155) : error C2065: 'StretchDIBits' : undeclared identifier C:\templ\prueba\xShadeButton.cpp(456) : error C2664: 'CreateFileW' : cannot convert parameter 1 from 'char *' to 'const unsigned short *' Types pointed to are unrelated; conversion requires reinterpret_cast, C-style cast or function-style cast C:\templ\prueba\xShadeButton.cpp(558) : error C2065: 'WM_MOUSELEAVE' : undeclared identifier C:\templ\prueba\xShadeButton.cpp(570) : error C2065: 'BS_FLAT' : undeclared identifier C:\templ\prueba\xShadeButton.cpp(636) : error C2065: 'DEFAULT_GUI_FONT' : undeclared identifier Yasmin Sign In·View Thread·PermaLink 1.60/5 (8 votes) Multiline Setting Mark Kozel 9:45 8 Feb '02   Is there a way to use the Multiline setting fot text on these buttons? Great Button Classs, by the way. -Mark Mark Kozel ITT Industries, Systems Division Say no to Smilies Sign In·View Thread·PermaLink 2.50/5 (2 votes) Re: Multiline Setting Anonymous 11:45 24 Jul '02   Was just looking for that myself... Sign In·View Thread·PermaLink 2.50/5 (2 votes)

Last Visit: Friday, January 9, 2009 3:41 PM     Last Update:Friday, January 9, 2009 3:41 PM 123 Next »