
Introduction
The article introduces an enhanced version of the standard MFC status bar control. The new class should enable you to easily add/remove panes to/from the application's status bar, on-the-fly. The status bar's panes may contain almost any control you need: buttons, edits, animations, progress bars, and etc.
The class is partially based on the status bar presented in the freeware version of the Prof-UIS library available here .
How to use it
The
CExtStatusControlBar
class is simple to use. To add it to your project, please follow the steps below:
- Put its source files ( CExtStatusControlBar.cpp and CExtStatusControlBar.h ) into the proper folder and add their file names to your Visual Studio project.
-
Include its header to the appropriate header file. If you plan to use
CExtStatusControlBar
in several places of your application, it's reasonable to add it to your stdafx.h file.#include " CExtStatusControlBar.h"
-
If you used
CStatusBar
, you should replace it withCExtStatusControlBar
everywhere in the project.CExtStatusControlBar m_wndStatusBar;
Sample
The StatusPanes sample project shows how to use the class in practice (including how to place controls into the control bar's panes).
List of methods
-
BOOL AddPane(UINT nID, int nIndex)
Inserts a new pane into the status bar.
Parameters
nID
- ID of the pane to be added.
nIndex
- The index of the newly created pane.
Return Value
- Nonzero if successful.
-
BOOL RemovePane(UINT nID)
Deletes a pane from the status bar.
Parameters
nID
- ID of the pane to be deleted.
Return Value
- Nonzero if successful.
-
BOOL AddPaneControl(CWnd* pWnd, UINT nID, BOOL bAutoDestroy)
Inserts a control into a specified pane.
Parameters
pWnd
- Pointer to the control to be added.
nID
- ID of the target pane.
bAutoDestroy
- Specifies whether the control should be destroyed when the pane is removed.
Return Value
- Nonzero if successful; otherwise zero.
-
BOOL AddPaneControl(HWND hWnd, UINT nID, BOOL bAutoDestroy)
Inserts a control into a specified pane.
Parameters
hWnd
- Handle to the control to be added.
nID
- ID of the target pane.
bAutoDestroy
- Specifies whether the control should be destroyed when the pane is removed.
Return Value
- Nonzero if successful.
-
void DisableControl( int nIndex, BOOL bDisable=TRUE)
Disables the control at a specified pane.
Parameters
nIndex
- Index of the pane.
bDisable
- Flag specifying that the control is enabled if it is set to
TRUE
.
-
int GetPanesCount() const
Retrieves the current number of panes in the status bar.
-
void SetPaneWidth( int nIndex, int nWidth)
Sets a width in pixels for a specified pane.
Parameters
nIndex
- Index of the pane.
nStyle
- Width to be set.
-
void SetPaneInfo( int nIndex, UINT nID, UINT nStyle, int cxWidth)
Sets the specified pane to a new ID, style and width.
Parameters
nIndex
- Index of the pane whose style is to be set.
nID
- New ID for the pane.
nStyle
- New style for the pane.
cxWidth
- New width for the pane.
-
void SetPaneStyle( int nIndex, UINT nStyle)
Sets the style of a status bar's pane. A pane's style determines how the pane appears.
Parameters
nIndex
- Index of the pane whose style is to be set.
nStyle
- Style of the pane whose style is to be set.
Copyright
You can use these sources for absolutely free.
Reporting bugs
Your questions, suggestions and bug reports may be posted either to the forum below or to the forum at the Prof-UIS website.
License
This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.
A list of licenses authors might use can be found here
CExtStatusControlBar - Managing status bar's panes is getting easier
更多文章、技術交流、商務合作、聯系博主
微信掃碼或搜索:z360901061

微信掃一掃加我為好友
QQ號聯系: 360901061
您的支持是博主寫作最大的動力,如果您喜歡我的文章,感覺我的文章對您有幫助,請用微信掃描下面二維碼支持博主2元、5元、10元、20元等您想捐的金額吧,狠狠點擊下面給點支持吧,站長非常感激您!手機微信長按不能支付解決辦法:請將微信支付二維碼保存到相冊,切換到微信,然后點擊微信右上角掃一掃功能,選擇支付二維碼完成支付。
【本文對您有幫助就好】元
