本文按字母順序整理 CButtonST 所有公開成員函數,包含參數說明、傳回值、列舉常數定義,作為開發時的快速查閱手冊。
| 函數名稱 | 用途 | 關鍵參數/傳回值 |
|---|---|---|
DrawBorder | 顯示/隱藏按鈕邊框 | BOOL bDrawBorder, BOOL bRepaint → BTNST_OK |
DrawFlatFocus | 平面按鈕焦點框顯示 | BOOL bDrawFlatFocus, BOOL bRepaint → BTNST_OK |
DrawTransparent | 啟用透明模式(不可逆) | BOOL bRepaint,內存保留背景拷貝 |
OffsetColor | 依基底色偏移產生狀態色 | BYTE byColorIndex, short shOffset, BOOL bRepaint → BTNST_OK/INVALIDINDEX/BADPARAM |
SetAlign | 設定圖示/文字相對位置 | BYTE byAlign (ST_ALIGN_HORIZ/VERT/HORIZ_RIGHT), BOOL bRepaint |
SetAlwaysTrack | 非啟動視窗也追蹤滑鼠 | BOOL bAlwaysTrack(預設 TRUE) |
SetBitmaps | 設定位圖(一般/熱/停用) | int nBitmapIn/Out, COLORREF crTransColor 或 HBITMAP 版本 |
SetBtnCursor | 設定滑鼠進入時游標 | int nCursorId, BOOL bRepaint |
SetCheck | CheckBox 模式狀態設定 | int nCheck (0/1), BOOL bRepaint |
SetColor | 直接指定狀態顏色 | BYTE byColorIndex, COLORREF crColor, BOOL bRepaint |
SetDefaultColors | 還原系統預設色彩 | BOOL bRepaint |
SetFlat | 設定平面/標準風格 | BOOL bFlat (TRUE=平面), BOOL bRepaint |
SetIcon | 設定圖示(一般/熱狀態) | int nIconIn/Out 或 HICON 版本,NULL 釋放資源 |
SetMenu | 指派下拉選單(需 BCMenu) | UINT nMenu, HWND hParentWnd, BOOL bWinXPStyle, UINT nToolbarID... |
SetTooltipText | 設定工具提示文字 | int nText 或 LPCTSTR lpszText,BOOL bActivate |
SetURL | 設定超連結網址 | LPCTSTR lpszURL,點擊自動開啟瀏覽器 |
byColorIndexBTNST_COLOR_BK_IN:滑鼠進入背景色BTNST_COLOR_FG_IN:滑鼠進入前景色(文字)BTNST_COLOR_BK_OUT:一般狀態背景色BTNST_COLOR_FG_OUT:一般狀態前景色BTNST_COLOR_BK_FOCUS:焦點狀態背景色BTNST_COLOR_FG_FOCUS:焦點狀態前景色byAlignST_ALIGN_HORIZ:圖示左、文字右(預設)ST_ALIGN_VERT:圖示上、文字下ST_ALIGN_HORIZ_RIGHT:圖示右、文字左BTNST_OK:成功BTNST_INVALIDINDEX:無效索引BTNST_INVALIDALIGN:無效對齊參數BTNST_INVALIDRESOURCE:資源讀取失敗BTNST_FAILEDMASK:遮罩建立失敗BTNST_BADPARAM:參數超出範圍(如色彩偏移超出 0-255)bRepaint=TRUE 即時重繪,批次設定時可設 FALSE 最後統一 Invalidate()OffsetColor 適合建立協調色系,SetColor 適合精確指定品牌色DrawTransparent 會佔用記憶體,僅在有背景圖片視窗必要時啟用BCMenu.h/cpp,定義 BTNST_USE_BCMENU 宏啟用擴充版 SetMenu此參考手冊涵蓋 CButtonST 17 個公開介面函數,配合列舉常數與傳回值定義,讓開發者無需翻閱原始碼即可快速掌握完整功能集。建議列印備查或整合至專案文件中。