首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
您现在的位置: 程式碼之家 >> 編程語言 >  >> C語言 >> VC >> 關於VC++

CButtonST 公開介面函數完整參考手冊

     編輯:關於VC++

本文按字母順序整理 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
SetCheckCheckBox 模式狀態設定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,點擊自動開啟瀏覽器

關鍵列舉常數定義

顏色索引 byColorIndex

  • BTNST_COLOR_BK_IN:滑鼠進入背景色
  • BTNST_COLOR_FG_IN:滑鼠進入前景色(文字)
  • BTNST_COLOR_BK_OUT:一般狀態背景色
  • BTNST_COLOR_FG_OUT:一般狀態前景色
  • BTNST_COLOR_BK_FOCUS:焦點狀態背景色
  • BTNST_COLOR_FG_FOCUS:焦點狀態前景色

對齊方式 byAlign

  • ST_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 個公開介面函數,配合列舉常數與傳回值定義,讓開發者無需翻閱原始碼即可快速掌握完整功能集。建議列印備查或整合至專案文件中。

  1. 上一篇文章:
  2. 下一篇文章:
Copyright © 程式碼之家 All Rights Reserved