翻译来源:https://www.codeproject.com/Articles/57/CButtonST-v-MFC-Flat-buttons?msg=5115581#xx5115581xx
这个类很常见,在很多源码中都有见到。
包含BtnST.cpp和BtnST.h
SoftechSoftware主页
SoftechSoftware Email
抽象
CButtonST是一个派生自MFC CButton类的类。
使用这个课程,您的应用程序可以具有标准按钮或具有“平面”风格的新的和现代的按钮!
主要CButtonST功能有:
- 标准CButton属性
- 文本和图标(或位图)在同一按钮上
- 只有文字或只有图标/位图按钮
- 支持任何尺寸的图标(最多256色)
- 支持位图
- 支持透明按钮(用于位图应用程序)
- 标准或平面按钮款式
- 将运行时间从平面更改为标准样式
- 按钮可以有两个图像。当鼠标在按钮上方时,当鼠标在外部时(仅适用于“平面”按钮)
- 每种颜色都可以定制
- 可以通过DDX_调用使用
- 可以在DLL中使用
- 可以动态创建
- 每个按钮都可以有自己的鼠标指针
- 当窗口处于非活动状态时,按钮也很危险,就像Internet Explorer中发生的那样
- 内置支持多线工具提示
- 内置菜单基本支持
- 内置支持所有者绘制菜单(使用BCMenu类)
- 内置基本支持声音
- 可以导出创建默认情况下不提供的其他按钮样式
- 包含完整的源代码!
- UNICODE兼容
- 现有应用中无需成本实现
点击 此处 查看使用CButtonST制作的真实世界应用程序。
如何在您的应用程序中集成CButtonST
在您的项目中包括以下文件:
- BtnST.h
- BtnST.cpp
这个第三方课程让您能够使用最新的视觉风格来显示菜单,如
最新的Microsoft产品或Windows XP中所示。
最新的BCMenu版本可以在 这里 找到。
要启用对BCMenu的支持,必须启用BtnST.h中的以下两行:
隐藏
复制代码
#define BTNST_USE_BCMENU #include "BCMenu.h"另外,您的项目中必须包含以下文件:
- BCMenu.h
- BCMenu.cpp
从版本3.6开始,CButtonST可以在特定按钮状态下播放声音。
要启用支持声音,必须启用BtnST.h中的以下行:
隐藏
复制代码
#define BTNST_USE_SOUND
这样可以访问
SetSound
方法。
静态创建CButtonST对象
使用对话框编辑器创建一个标准按钮,例如,IDOK(您不需要将其绘制为所有者),并为此按钮创建一个成员变量:
隐藏
复制代码
CButtonST m_btnOk;现在将按钮附加到CButtonST。对于基于对话的应用程序,在OnInitDialog中:
隐藏
复制代码
// Call the base-class method CDialog::OnInitDialog(); // Create the IDOK button m_btnOk.SubclassDlgItem(IDOK, this);或在您的DoDataExchange中:
隐藏
复制代码
// Call the base method CDialog::DoDataExchange(pDX); // Create the IDOK button DDX_Control(pDX, IDOK, m_btnOk);动态创建CButtonST对象
在应用程序中,为该按钮创建一个成员变量。请注意,这个变量是一个 指针 :
隐藏
复制代码
CButtonST* m_pbtnOk;现在创建按钮。对于基于对话的应用程序,在OnInitDialog中:
隐藏
复制代码
// Call the base-class method CDialog::OnInitDialog(); // Create the IDOK button m_pbtnOk = new CButtonST; m_pbtnOk->Create(_T("&Ok"), WS_CHILD | WS_VISIBLE | WS_GROUP | WS_TABSTOP, <BR> CRect(10, 10, 200, 100), this, IDOK); // Set the same font of the application m_pbtnOk->SetFont(GetFont());记住要摧毁按钮,否则会发生内存泄漏。这可以做到,例如,在你的类析构函数中:
隐藏
复制代码
if (m_pbtnOk) delete m_pbtnOk;
类方法
SetIcon(使用多尺寸资源)
为按钮分配图标。
任何以前的图标或位图都将被删除。
隐藏
收缩
复制代码
// Parameters: // [IN] nIconIn // ID number of the icon resource to show when the mouse is over the<BR>// button. Pass NULL to remove any icon from the button. // [IN] nCxDesiredIn // Specifies the width, in pixels, of the icon to load. // [IN] nCyDesiredIn // Specifies the height, in pixels, of the icon to load. // [IN] nIconOut // ID number of the icon resource to show when the mouse is outside <BR>// the button. Can be NULL. // If this parameter is the special value BTNST_AUTO_GRAY (cast to int) <BR>// the second icon will be automatically created starting from nIconIn <BR>// and converted to grayscale. // If this parameter is the special value BTNST_AUTO_DARKER (cast <BR>// to int) the second icon will be automatically created 25% <BR>// darker starting from nIconIn. // [IN] nCxDesiredOut // Specifies the width, in pixels, of the icon to load. // [IN] nCyDesiredOut // Specifies the height, in pixels, of the icon to load. // // Return value: // BTNST_OK // Function executed successfully. // BTNST_INVALIDRESOURCE // Failed loading the specified resource. // DWORD SetIcon(int nIconIn, int nCxDesiredIn, int nCyDesiredIn, <BR> int nIconOut = NULL, int nCxDesiredOut = 0, int nCyDesiredOut = 0)SetIcon (使用资源)
将图标分配给按钮。
任何以前的图标或位图都将被删除。
隐藏
复制代码
// Parameters: // [IN] nIconIn // ID number of the icon resource to show when the mouse is over the <BR>// button. // Pass NULL to remove any icon from the button. // [IN] nIconOut // ID number of the icon resource to show when the mouse is <BR>// outside the button. Can be NULL. // If this parameter is the special value BTNST_AUTO_GRAY (cast to int) <BR>// the second icon will be automatically created starting from <BR>// nIconIn and converted to grayscale. If this parameter is the <BR>// special value BTNST_AUTO_DARKER (cast to int) the second // icon will be automatically created 25% darker starting from nIconIn. // // Return value: // BTNST_OK // Function executed successfully. // BTNST_INVALIDRESOURCE // Failed loading the specified resource. // DWORD SetIcon(int nIconIn, int nIconOut = NULL)SetIcon (使用手柄)
将图标分配给按钮。
任何以前的图标或位图都将被删除。
隐藏
复制代码
// Parameters: // [IN] hIconIn // Handle fo the icon to show when the mouse is over the button. // Pass NULL to remove any icon from the button. // [IN] hIconOut // Handle to the icon to show when the mouse is outside the button. <BR>// Can be NULL. // If this parameter is the special value BTNST_AUTO_GRAY the second // icon will be automatically created starting from hIconIn and <BR>// converted to grayscale. // If this parameter is the special value BTNST_AUTO_DARKER the second // icon will be automatically created 25% darker starting from hIconIn. // // Return value: // BTNST_OK // Function executed successfully. // BTNST_INVALIDRESOURCE // Failed loading the specified resource. // DWORD SetIcon(HICON hIconIn, HICON hIconOut = NULL)SetBitmaps (使用资源)
为按钮分配位图。
任何以前的图标或位图都将被删除。
隐藏
复制代码
// Parameters: // [IN] nBitmapIn // ID number of the bitmap resource to show when the mouse is <BR>// over the button. // Pass NULL to remove any bitmap from the button. // [IN] crTransColorIn // Color (inside nBitmapIn) to be used as transparent color. // [IN] nBitmapOut // ID number of the bitmap resource to show when the mouse <BR>// is outside the button. // Can be NULL. // [IN] crTransColorOut // Color (inside nBitmapOut) to be used as transparent color. // // Return value: // BTNST_OK // Function executed successfully. // BTNST_INVALIDRESOURCE // Failed loading the specified resource. // BTNST_FAILEDMASK // Failed creating mask bitmap. // DWORD SetBitmaps(int nBitmapIn, COLORREF crTransColorIn, <BR> int nBitmapOut = NULL, COLORREF crTransColorOut = 0)
SetBitmaps(使用句柄)
为按钮分配位图。
任何以前的图标或位图都将被删除。
隐藏
复制代码
// Parameters: // [IN] hBitmapIn // Handle fo the bitmap to show when the mouse is over the button. // Pass NULL to remove any bitmap from the button. // [IN] crTransColorIn // Color (inside hBitmapIn) to be used as transparent color. // [IN] hBitmapOut // Handle to the bitmap to show when the mouse is outside the button. // Can be NULL. // [IN] crTransColorOut // Color (inside hBitmapOut) to be used as transparent color. // // Return value: // BTNST_OK // Function executed successfully. // BTNST_INVALIDRESOURCE // Failed loading the specified resource. // BTNST_FAILEDMASK // Failed creating mask bitmap. // DWORD SetBitmaps(HBITMAP hBitmapIn, COLORREF crTransColorIn, <BR> HBITMAP hBitmapOut = NULL, COLORREF crTransColorOut = 0)
SetFlat
将按钮设置为具有标准或平面样式。
隐藏
复制代码
// Parameters: // [IN] bFlat // If TRUE the button will have a flat style, else // will have a standard style. // By default, CButtonST buttons are flat. // [IN] bRepaint // If TRUE the control will be repainted. // // Return value: // BTNST_OK // Function executed successfully. // DWORD SetFlat(BOOL bFlat = TRUE, BOOL bRepaint = TRUE)SetAlign
设置图标/位图和文本之间的对齐类型。
隐藏
复制代码
// Parameters: // [IN] byAlign // Alignment type. Can be one of the following values: // ST_ALIGN_HORIZ Icon/bitmap on the left, text on the right // ST_ALIGN_VERT Icon/bitmap on the top, text on the bottom // ST_ALIGN_HORIZ_RIGHT Icon/bitmap on the right, text on the left // ST_ALIGN_OVERLAP Icon/bitmap on the same space as text // By default, CButtonST buttons have ST_ALIGN_HORIZ alignment. // [IN] bRepaint // If TRUE the control will be repainted. // // Return value: // BTNST_OK // Function executed successfully. // BTNST_INVALIDALIGN // Alignment type not supported. // DWORD SetAlign(BYTE byAlign, BOOL bRepaint = TRUE)SetPressedStyle
设置按下的样式。
隐藏
复制代码
// Parameters: // [IN] byStyle // Pressed style. Can be one of the following values: // BTNST_PRESSED_LEFTRIGHT Pressed style from left to right (as usual) // BTNST_PRESSED_TOPBOTTOM Pressed style from top to bottom // By default, CButtonST buttons have BTNST_PRESSED_LEFTRIGHT style. // [IN] bRepaint // If TRUE the control will be repainted. // // Return value: // BTNST_OK // Function executed successfully. // BTNST_INVALIDPRESSEDSTYLE // Pressed style not supported. // DWORD SetPressedStyle(BYTE byStyle, BOOL bRepaint = TRUE)SetCheck
设置复选框的状态。
如果按钮不是复选框,则此功能无意义。
隐藏
复制代码
// Parameters: // [IN] nCheck // 1 to check the checkbox. // 0 to un-check the checkbox. // [IN] bRepaint // If TRUE the control will be repainted. // // Return value: // BTNST_OK // Function executed successfully. // DWORD SetCheck(int nCheck, BOOL bRepaint = TRUE)GetCheck
返回复选框的当前状态。
如果按钮不是复选框,则此功能无意义。
隐藏
复制代码
// Return value: // The current state of the checkbox. // 1 if checked. // 0 if not checked or the button is not a checkbox. // int GetCheck()SetDefaultColors
将所有颜色设置为默认值。
隐藏
复制代码
// Parameters: // [IN] bRepaint // If TRUE the control will be repainted. // // Return value: // BTNST_OK // Function executed successfully. // DWORD SetDefaultColors(BOOL bRepaint = TRUE)SetColor
设置用于特定状态的颜色。
隐藏
复制代码
// Parameters: // [IN] byColorIndex // Index of the color to set. Can be one of the following values: // BTNST_COLOR_BK_IN Background color when mouse is over the button // BTNST_COLOR_FG_IN Text color when mouse is over the button // BTNST_COLOR_BK_OUT Background color when mouse is outside the button // BTNST_COLOR_FG_OUT Text color when mouse is outside the button // BTNST_COLOR_BK_FOCUS Background color when the button is focused // BTNST_COLOR_FG_FOCUS Text color when the button is focused // [IN] crColor // New color. // [IN] bRepaint // If TRUE the control will be repainted. // // Return value: // BTNST_OK // Function executed successfully. // BTNST_INVALIDINDEX // Invalid color index. // DWORD SetColor(BYTE byColorIndex, COLORREF crColor, BOOL bRepaint = TRUE)GetColor
返回用于特定状态的颜色。
隐藏
复制代码
// Parameters: // [IN] byColorIndex // Index of the color to get. // See SetColor for the list of available colors. // [OUT] crpColor // A pointer to a COLORREF that will receive the color. // // Return value: // BTNST_OK // Function executed successfully. // BTNST_INVALIDINDEX // Invalid color index. // DWORD GetColor(BYTE byColorIndex, COLORREF* crpColor)OffsetColor
此功能将偏移量应用于指定颜色的RGB分量。
该功能可以被看作是使颜色比默认值更暗或更轻的简单方法。
隐藏
复制代码
// Parameters: // [IN] byColorIndex // Index of the color to set. // See SetColor for the list of available colors. // [IN] shOffsetColor // A short value indicating the offset to apply to the color. // This value must be between -255 and 255. // [IN] bRepaint // If TRUE the control will be repainted. // // Return value: // BTNST_OK // Function executed successfully. // BTNST_INVALIDINDEX // Invalid color index. // BTNST_BADPARAM // The specified offset is out of range. // DWORD OffsetColor(BYTE byColorIndex, short shOffset, BOOL bRepaint = TRUE)SetAlwaysTrack
设置按钮的高亮逻辑。
仅适用于扁平按钮。
隐藏
复制代码
// Parameters: // [IN] bAlwaysTrack // If TRUE the button will be hilighted even if the window that owns it, is // not the active window. // If FALSE the button will be hilighted only if the window that owns it, // is the active window. // // Return value: // BTNST_OK // Function executed successfully. // DWORD SetAlwaysTrack(BOOL bAlwaysTrack = TRUE)SetBtnCursor
设置当鼠标在按钮上方时使用的光标。
隐藏
复制代码
// Parameters: // [IN] nCursorId // ID number of the cursor resource. // Pass NULL to remove a previously loaded cursor. // [IN] bRepaint // If TRUE the control will be repainted. // // Return value: // BTNST_OK // Function executed successfully. // BTNST_INVALIDRESOURCE // Failed loading the specified resource. // DWORD SetBtnCursor(int nCursorId = NULL, BOOL bRepaint = TRUE)DrawBorder
设置是否必须绘制按钮边框。
仅适用于扁平按钮。
隐藏
复制代码
// Parameters: // [IN] bDrawBorder // If TRUE the border will be drawn. // [IN] bRepaint // If TRUE the control will be repainted. // // Return value: // BTNST_OK // Function executed successfully. // DWORD DrawBorder(BOOL bDrawBorder = TRUE, BOOL bRepaint = TRUE)DrawFlatFocus
设置是否必须为平面按钮绘制焦点矩形。
隐藏
复制代码
// Parameters: // [IN] bDrawFlatFocus // If TRUE the focus rectangle will be drawn also for flat buttons. // [IN] bRepaint // If TRUE the control will be repainted. // // Return value: // BTNST_OK // Function executed successfully. // DWORD DrawFlatFocus(BOOL bDrawFlatFocus, BOOL bRepaint = TRUE)SetTooltipText (使用资源)
设置在按钮工具提示中显示的文本。
隐藏
复制代码
// Parameters: // [IN] nText // ID number of the string resource containing the text to show. // [IN] bActivate // If TRUE the tooltip will be created active. // void SetTooltipText(int nText, BOOL bActivate = TRUE)SetTooltipText
设置在按钮工具提示中显示的文本。
隐藏
复制代码
// Parameters: // [IN] lpszText // Pointer to a null-terminated string containing the text to show. // [IN] bActivate // If TRUE the tooltip will be created active. // void SetTooltipText(LPCTSTR lpszText, BOOL bActivate = TRUE)EnableBalloonTooltip
启用使用气球样式显示工具提示。
在调用SetTooltipText之前,必须调用此函数。
隐藏
复制代码
// Return value: // BTNST_OK // Function executed successfully. // DWORD EnableBalloonTooltip()ActivateTooltip
启用或禁用按钮工具提示。
隐藏
复制代码
// Parameters: // [IN] bActivate // If TRUE the tooltip will be activated. // void ActivateTooltip(BOOL bEnable = TRUE)GetDefault
返回如果按钮是默认按钮。
隐藏
复制代码
// Return value: // TRUE // The button is the default button. // FALSE // The button is not the default button. // BOOL GetDefault()DrawTransparent
启用透明模式。
注意:此操作不可逆。
DrawTransparent应该在创建按钮之后调用。
在您真正需要它之前,请勿使用trasparent按钮(您有位图
背景),因为每个透明按钮都会在其背景内存中复制内容。
这可能会导致不必要的内存使用和执行过载。
隐藏
复制代码
// Parameters: // [IN] bRepaint // If TRUE the control will be repainted. // void DrawTransparent(BOOL bRepaint = FALSE)SetURL
设置点击按钮时打开的URL。
隐藏
复制代码
// Parameters: // [IN] lpszURL // Pointer to a null-terminated string that contains the URL. // Pass NULL to removed any previously specified URL. // // Return value: // BTNST_OK // Function executed successfully. // DWORD SetURL(LPCTSTR lpszURL = NULL)SetMenu
将菜单关联到按钮。
菜单将显示单击按钮。
仅当 BTNST_USE_BCMENU未定义 时,此方法才可用。
隐藏
复制代码
// Parameters: // [IN] nMenu // ID number of the menu resource. // Pass NULL to remove any menu from the button. // [IN] hParentWnd // Handle to the window that owns the menu. // This window receives all messages from the menu. // [IN] bRepaint // If TRUE the control will be repainted. // // Return value: // BTNST_OK // Function executed successfully. // BTNST_INVALIDRESOURCE // Failed loading the specified resource. // DWORD SetMenu(UINT nMenu, HWND hParentWnd, BOOL bRepaint = TRUE)SetMenu
将菜单关联到按钮。
菜单将显示单击按钮。
仅当定义了 BTNST_USE_BCMENU 时,此方法才可用。该菜单将由BCMenu类处理。
隐藏
收缩
复制代码
// Parameters: // [IN] nMenu // ID number of the menu resource. // Pass NULL to remove any menu from the button. // [IN] hParentWnd // Handle to the window that owns the menu. // This window receives all messages from the menu. // [IN] bWinXPStyle // If TRUE the menu will be displayed using the new Windows XP style. // If FALSE the menu will be displayed using the standard style. // [IN] nToolbarID // Resource ID of the toolbar to be associated to the menu. // [IN] sizeToolbarIcon // A CSize object indicating the size (in pixels) of each icon <BR>// into the toolbar. // All icons into the toolbar must have the same size. // [IN] crToolbarBk // A COLORREF value indicating the color to use as background <BR>// for the icons into the toolbar. // This color will be used as the "transparent" color. // [IN] bRepaint // If TRUE the control will be repainted. // // Return value: // BTNST_OK // Function executed successfully. // BTNST_INVALIDRESOURCE // Failed loading the specified resource. // DWORD SetMenu(UINT nMenu, HWND hParentWnd, BOOL bWinXPStyle = TRUE, UINT nToolbarID = NULL, CSize sizeToolbarIcon = CSize(16, 16), COLORREF crToolbarBk = RGB(255, 0, 255), BOOL bRepaint = TRUE)SetMenuCallback
设置在显示
与该按钮相关的菜单之前将发送到指定窗口的回调消息。
隐藏
复制代码
// Parameters: // [IN] hWnd // Handle of the window that will receive the callback message. // Pass NULL to remove any previously specified callback message. // [IN] nMessage // Callback message to send to window. // [IN] lParam // A 32 bits user specified value that will be passed to the <BR>// callback function. // // Remarks: // the callback function must be in the form: // LRESULT On_MenuCallback(WPARAM wParam, LPARAM lParam) // Where: // [IN] wParam // If support for BCMenu is enabled: a pointer to BCMenu // else a HMENU handle to the menu that is being to be <BR>// displayed. // [IN] lParam // The 32 bits user specified value. // // Return value: // BTNST_OK // Function executed successfully. // DWORD SetMenuCallback(HWND hWnd, UINT nMessage, LPARAM lParam = 0)SizeToContent
将按钮调整为与图像大小相同的按钮。
为了获得良好的效果,IN和OUT图像应具有相同的大小。
隐藏
复制代码
void SizeToContent()
SetSound
设置特定按钮状态下必须播放的声音。
此方法仅在定义了BTNST_USE_SOUND时 可用 。
隐藏
复制代码
// Parameters: // [IN] lpszSound // A string that specifies the sound to play. // If hMod is NULL this string is interpreted as a filename, <BR>// else it is interpreted as a resource identifier. // Pass NULL to remove any previously specified sound. // [IN] hMod // Handle to the executable file that contains the resource to <BR>// be loaded. // This parameter must be NULL unless lpszSound specifies a <BR>// resource identifier. // [IN] bPlayOnClick // TRUE if the sound must be played when the button is clicked. // FALSE if the sound must be played when the mouse is moved over <BR>// the button. // [IN] bPlayAsync // TRUE if the sound must be played asynchronously. // FALSE if the sound must be played synchronously. The <BR>// application takes control after the sound is completely played. // // Return value: // BTNST_OK // Function executed successfully. // DWORD SetSound(LPCTSTR lpszSound, HMODULE hMod = NULL, BOOL bPlayOnClick = FALSE, BOOL bPlayAsync = TRUE)OnDrawBackground
每次按钮背景需要绘制时,此函数被调用。
如果按钮处于透明模式,则 不会 调用此功能。
这是一个虚拟函数,可以在CButtonST派生类中重写,
以产生默认情况下不可用的整个范围的按钮。
隐藏
复制代码
// Parameters: // [IN] pDC // Pointer to a CDC object that indicates the device context. // [IN] pRect // Pointer to a CRect object that indicates the bounds of the // area to be painted. // // Return value: // BTNST_OK // Function executed successfully. // virtual DWORD OnDrawBackground(CDC* pDC, CRect* pRect)OnDrawBorder
每当需要绘制按钮边框时调用此函数。
这是一个虚拟函数,可以在CButtonST派生类中重写,
以产生默认情况下不可用的整个范围的按钮。
隐藏
复制代码
// Parameters: // [IN] pDC // Pointer to a CDC object that indicates the device context. // [IN] pRect // Pointer to a CRect object that indicates the bounds of the // area to be painted. // // Return value: // BTNST_OK // Function executed successfully. // virtual DWORD OnDrawBorder(CDC* pDC, CRect* pRect)GetVersionI
将类版本作为一个简短的值返回。
隐藏
复制代码
// Return value: // Class version. Divide by 10 to get actual version. // static short GetVersionI()GetVersionC
返回类版本作为字符串值。
隐藏
复制代码
// Return value: // Pointer to a null-terminated string containig the class version. // static LPCTSTR GetVersionC()