FxButton Class






4.75/5 (21 votes)
Jan 31, 2003
4 min read

191789

14567
FxButton allows developers to create customized buttons using captions, bitmaps, tooltips, etc.
- Download demo project 1 - 173 Kb
- Download demo project 2 - 758 Kb
- Download source - 27 Kb
- Download Full Doc (.chm help file) - 110 Kb
Introduction
FxButton allows developers to create customized buttons using captions, bitmaps, tooltips, etc. It cannot do everything, so be sure to check its limitations. I'm a beginner in coding VC++ with MFC and I made this class for fun and - above all - to learn.
The aim of this class - but not the only one - is to make it as easy as possible to integrate it in an application and to have the maximum options available. If you don't know what a handle is and you want a bitmap button, you can use this class.
The first FxButton demo is not a button gallery; it contains only one FxButton but you can play with it. The demo gives access to about 30 button components. Each of these options can be applied to any button state: normal, pushed, over or disabled.
The second FxButton demo is a button gallery. It shows the use of clipping regions for buttons and transparent bitmaps applied to push, check or radio buttons.
What's new in this update
a very minor change but it killed a bad bug. Applications no more crash after a few minutes of execution. I didn't test with Win98-95 but it's ok for the others.
Background (optional)
Limitations
First of all, you may want to know what FxButton cannot do before reading through this document without finding what you're looking for. You should not use FxButton class if you :
- Want to see animated bitmaps or AVIs on a button.
- Want to see animated text, flashing colors, or use GIF pictures.
- Need to use a check button with the 3States property.
- Want an auto-sized button with the bitmap size drawn on it.
- Want a button which automatically takes into account all the basic and extended styles available on the Resource Editor of Visual C++.
- Want to have 5 different bitmaps and 5 different clipping windows using only 2 GDI objects.
- Want to create a heavily customized button with only 3 lines of codes.
What Fx Button does
An FxButton can contain different data for the normal, pushed, over and disabled states. This means it can manage 4 bitmaps, 4 captions, 4 background colors, etc. Here is a list of all the button items :
- Background color
- Border color and size
- Bitmap
- Transparent bitmap
- Backscreen bitmap
- Text
- Tooltips
- Focus
- Cursor
- Sound
- Clipping region
Some other features:
- The bitmap can be stretched to any position on the button rectangle.
- The caption can be drawn anywhere on the button
- Many others options are available; just see the demo and the documents.
- Button types include: push, radio, check, push-like for check and radio buttons.
- Buttons can be rounded rectangles.
- The focus can alter colors in more of the classic rectangle.
- Use 2 transparent colors for bitmap and clipping regions. It can have different bitmaps while maintaining the same custom clipping region.
Using the code
All FxButton initialization methods start with SetFx
, which is a
great help when you make your button. Here's an example to show how simple it
can be.
Let's say your button is called myButton
.
// Init text myButton.SetFxText("Ok"); myButton.SetFxTextFont("Arial"); // Init bitmap myButton.SetFxBitmap("IDB_BITMAP1"); myButton.SetFxBitmapTransparentColor1(RGB(0,255,0)); // Init background color myButton.SetFxBkcolor(RGB(100,100,100)); // Create the button myButton.FxCreateButton();
Of interest is that the SetFx
methods allow developers to set
the values for the 4 button states. Almost all SetFx
methods have
this same rule. Here is one example to set the text:
SetFxText(CString Normal="", bool Duplicate=true, CString Pushed="", CString Over="", CString Disabled="");The
Normal
, Pushed
, Over
and
Disabled
states are the text values for each button state.
Duplicate
indicates if the Normal
value is to be
applied to other button states if they are not set. The best way to test a
button state is to set its text like:
myButton.SetFxText("Normal", true, "Pushed", "Over", "Disabled");
Now just play with mouse to see the text change.
This one has no text in its normal state, but silently tells you when the mouse is over it, thanks you when clicked, and it hates being disabled. This "silent notification" text button is:
myButton.SetFxText("", false, "Thanks", "Click me !", "Oh No !");
Now you can apply all the SetFx
methods in the same way. Here is
the SetFx
methods list:
Button Sets
SetFxClippingMode SetFxClippingColor1 SetFxClippingColor2
Background
SetFxBkColor SetFxBkColorMode
Borders
SetFxBorderSize SetFxBorderColorMode SetFxBorderEffect
Bitmap
SetFxBitmap SetFxBitmapRect SetFxBitmapPosition SetFxBitmapTransparentColor1 SetFxBitmapTransparentColor2 SetFxBitmapTransparentMode SetFxBitmapEffect
Text
SetFxText SetFxTextRect SetFxTextPosition SetFxTextFont SetFxTextSize SetFxTextColor SetFxTextStyle SetFxTextEffect
Media
SetFxSound SetFxCursor SetFxSystemCursor
Tooltip
SetFxToolTip
These SetFx
methods initialize the data members. To avoid too
many data members, they are stored in structures which are:
m_Background m_Bitmap m_Border m_Text m_Focus m_Media m_ToolTip m_Button m_Control
Only the 9 data members help performance. See the documentation for more details about them.
Points of Interest
As shown in the demo, the button can be entirely recreated. Since the clipping regions, bitmaps, colors, captions, etc., can easily be modified, this class could implement a skined application. Another interesting point is the facility to recreate a button. The FxButton class allows developers to change the button bitmaps and clipping regions easily.
History
November 2003 : First update
Fix bug
application crashes -
Bitmap drawing anywhere etc...
Improvment
No need to Invalidate
if you change the text or style or color etc...