综述
控件类型 | WNDCLASS | MFC类 | |
---|---|---|---|
Animation | “SysAnimate32” | CAnimateCtrl | ANIMATE_CLASS |
ComboBoxEx | “ComboBoxEx32” | CComboBoxEx | WC_COMBOBOXEX |
Data-Time | “SysDateTimePick32” | CDataTimeCtrl | DATETIMEPICK_CLASS |
Header | “SysHeader32” | CHeaderCtrl | WC_HEADER |
Hotkey | “msctls-hotkey32” | CHotkeyCtrl | HOTKEY_CLASS |
Image List | N/A | CImageList | N/A |
Ip Address | “SysIpAddress32” | CIpAddressCtrl | WC_IPADDRESS |
List-View | “SysListView32” | CListCtrl | WC_LISTVIEW |
Month Calendar | “SysMonthCal32” | CMonthCalCtrl | MONTHCAL_CLASS |
Progress | “msctls_Progress32” | CProgressCtrl | PROGRESS_CLASS |
Property Sheet | N/A | CPropertySheet | N/A |
Rebar | “ReBarWindow32” | CReBarCtrl | REBARCLASSNAME |
Rich edit | “RichEdit20A” “RichEdit20W” | CRichEditCtrl | RICHEDIT_CLASS |
Slider | “msctls_trackbar32” | CSliderCtrl | TRACKBAR_CLASS |
Spin Button | “msctls_updown32” | CSpinButtonCtrl | UPDOWN_CLASS |
Status bar | “msctls_statusbar32” | CStatusBarCtrl | STATUSCLASSNAME |
Tab | “SysTabControl32” | CTabCtrl | WC_TABCONTROL |
Tool bar | “ToolbarWindow32” | CToolBarCtrl | TOOLBARCLASSNAME |
ToolTip | “tooltips_class32” | CToolTipCtrl | TOOLTIPS_CLASS |
TreeView | “SysTreeView32” | CTreeCtrl | WC_TREEVIEW |
void GetComctlVersion(DWORD &dwMajor, DWORD &dwMinor)
{
dwMajor = dwMinor = 0;
HINSTANCE hLib = ::LoadLibrary(_T("Comctl32.dll"));
if(hLib != NULL)
{
DLLGETVERSIONPROC pDllGetVersion =
(DLLGETVERSIONPROC)::GetProcAddress(hLib, _T("DllGetVersion"));
if(pDllGetVersion)
{
DLLVERSIONINFO dvi;
::ZeroMemory(&dvi, sizeof(dvi));
dvi.cbSize = sizeof(dvi);
HRESULT hr = (*pDllGetVersion)(&dvi);
if(SUCCEEDED(hr))
{
dwMajor = dvi.dwMajorVersion;
dwMinor = dvi.dwMinorVersion;
}
}
else
{
dwMajor = 4;
dwMinor = 0;
}
::FreeLibrary(hLib);
}
}
创建公用控件
// 1
#include <afxcmn.h>
...
CProgressCtrl wndProgress;
wndProgress.Create(WS_CHILD | WS_VISIBLE | WS_BORDER, CRect(x1, y1, x2, y2), this, IDC_PROGRESS);
…
// 2
// 对话框RC
CONTROL "", IDC_PROGRESS, PROGRESS_CLASS, WS_BORDER, 32, 32, 80, 16
公用控件公有得一些样式:
CCS_TOP
CCS_BOTTOM
CCS_LEFT
CCS_RIGHT
CCS_VERT
CCS_NOMOVEX 父窗口大小变化时,禁止控件随之调整大小和位置。X方向。
CCS_NOMOVEY 父窗口大小变化时,禁止控件随之调整大小和位置。Y方向。
CCS_NORESIZE 禁止控件随父窗口尺寸变化调整大小
CCS_NOPARENTALIGN
CCS_NODIVIDER 清除工具栏控件顶部得分隔栏
CCS_ADJUSTABLE
SDK风格应用中用公用控件,需调用 ::InitCommonControls/::InitCommonControlsEx加载Comctl32.dll,并注册控件得WNDCLASS。
在应用程序中多次调用::InitCommonControls/::InitCommonControlsEx无不良影响。
处理WM_NOTIFY:
公用控件把通知封装在WM_NOTIFY中。
WM_NOTIFY:
wParam:子窗口ID
lParam:NMHDR*
typedef struct tagNMHDR
{
HWND hwndFrom; // 控件得窗口句柄
UINT idFrom; // 控件ID
UINT code; // 通知码
}NMHDR;
所有通用控件都传送的一些通知:
NM_CLICK
NM_DBLCLK
NM_RCLICK
NM_RDBLCLK
NM_RETURN 控件有焦点时,按下Enter发送。
NM_KILLFOCUS
NM_SETFOCUS
NM_OUTOFMEMORY
大部分公用控件有属于其自身特别的通知码。
例:
// 树形视图展开
TVN_ITEMEXPANDED
lParam:NM_TREEVIEW*
typedef struct _NM_TREEVIEW
{
NMHDR hdr;
UINT action;
TV_ITEM itemOld;
TV_ITEM itemNew;
POINT ptDrag;
}NM_TREEVIEW;
// 树形视图获取信息
TVN_GETDISPINFO
lParam:TV_DISPINFO
typedef struct _TV_DISPINFO
{
NMHDR hdr;
TV_ITEM item;
}TV_DISPINFO;
封装在WM_NOTIFY消息中的通知通过ON_NOTIFY,ON_NOTIFY_RANGE宏,映射到类的成员函数。
ON_NOTIFY_REFLECT将其反射回控件。
传给ON_NOTIFY处理程序的参数pnmh就是WM_NOTIFY的lParam。参数 pResult传递函数返回值,意义需依靠特定控件特定消息确定。
滑杆控件
样式:
TBS_HORZ 水平放置
TBS_VERT 竖直放置
TBS_LEFT 刻度线画在竖直滑杆左
TBS_RIGHT 刻度线画在竖直滑杆右
TBS_TOP 刻度线画在水平滑杆上
TBS_BOTTOM 刻度线画在水平滑杆下
TBS_BOTH
TBS_NOTICKS 无刻度线
TBS_AUTOTICKS 每个停止位一个刻度线
TBS_FIXEDLENGTH
TBS_NOTHUMB
TBS_ENABLESELRANGE
TBS_TOOLTIPS
SliderCtrl:
SetRange/GetRange
SetPos/GetPos
SetTicFreq //设置刻度线间距离
SetSelection
m_wndSlider.SetRange(0, 8);
m_wndSlider.SetTick(2);
m_wndSlider.SetTick(3);
m_wndSlider.SetTick(6);
m_wndSlider.SetPos(2);
UI自定义:
从CSilderCtrl派生一个类,添加消息处理。改变对按键和鼠标的响应。
移动滑块时,滑杆向其父窗口发WM_HSCROLL,WM_VSCROLL。
滑杆控件的OnHScroll,OnVScroll接收三个参数:
1.通知码
2.滑块位置
3.CScrollBar*
滑杆通知:
TB_TOP 滑杆有输入焦点 + 按下Home
TB_BOTTOM 滑杆有输入焦点 + 按下End
TB_LINEDOWN 滑杆有输入焦点 + 按下向下/右
TB_LINEUP 滑杆有输入焦点 + 按下向上/左
TB_PAGEDOWN 滑杆有输入焦点 + 按下PageDown,单击滑块右/下 单击区间不含滑块。
TB_PAGEUP
TB_THUMBTRACK 鼠标把滑块拖动到新位置
TB_THUMBPOSITION 鼠标拖后,释放
TB_ENDTRACK
CSilderCtrl:
SetPageSize
GetTic
GetTicPos
GetTicArray
GetNumTicks
ClearSel
微调按钮控件
样式:
UDS_HORZ 箭头是水平的。
UDS_WRAP 如前进后退,超过边界值,位置按环式结构确定
UDS_ARROWKEYS 添加键盘接口
UDS_NOTHOUSANDS 消除千位分隔符
UDS_SETBUDDYINT 位置变化时,更新伙伴控件的文本
UDS_AUTOBUDDY 按Z向顺序选以前的控件做微调按钮的伙伴
UDS_ALIGNRIGHT
UDS_ALIGNLEFT
选择按钮控件和它的伙伴控件
// 1
CSpinButtonCtrl::SetBuddy(CWnd*)
// 2
// 创建微调按钮控件时指定UDS_AUTOBUDDY,则微调按钮控件自动按Z向顺序选中以前的控件作为它的伙伴
// RC
EDITTEXT IDC_EDIT, 60, 80, 40, 14, ES_AUTOHSCROLL
CONTROL "", IDC_SPIN, "msctls_updown32", UDS_SETBUDDYINT | UDS_AUTOBUDDY | UDS_ALIGNRIGHT, 0, 0, 0, 0
CSpinButtonCtrl::SetBase // 设置以什么进制来显示数值
微调按钮控件中每单击一次箭头,位置会前进或后退一个。
UDACCEL uda[4];
uda[0].nSec = 0;
uda[0].nInc = 1;
uda[1].nSec = 2;
uda[1].nInc = 2;
uda[2].nSec = 4;
uda[2].nInc = 10;
uda[3].nSec = 8;
uda[3].nInc = 100;
pSpinButton->SetAccel(4, uda);
UINT nCount = pSpinButton->GetAccel(0, NULL);
UDACCEL *puda = new UDACCEL[nCount];
pSpinButton->GetAccel(nCount, puda);
delete[] puda;
位置变化前,微调按钮控件向其父窗口发WM_NOTIFY消息。
通知码:UDN_DELTAPOS
lParam:NM_UPDOWN*
处理程序把*pResult设为FALSE,表允许变化发生。
跟在UDN_DELTAPOS通知后的是WM_HSCROLL或WM_VSCROLL。
工具提示控件
CToolTipCtrl
CToolTipCtrl::Create // 创建一个工具提示控件
m_ctlTT.Create(this);
创立后,下一步是在其中添加工具,
工具可以是另外一个窗口,也可是窗口的一个矩形区域。
一个工具提示控件可连接任意个工具。
m_ctlTT.AddTool(pWnd, _T("This a Window"), NULL, 0);
m_ctlTT.AddTool(pWnd, _T("This a Window"), CRect(32, 32, 64, 64), IDT_RECTANGLE);
MFC的工具提示控件具备子类划分能力。
class CMyToolTipCtrl : public CToolTipCtrl
{
public:
BOOL AddWindowTool(CWnd* pWnd, LPCTSTR pszText);
BOOL AddRectTool(CWnd* pWnd, LPCTSTR pszText, LPCRECT pRect, NULL, UINT nIDTool);
};
// cpp
BOOL CMyToolTipCtrl::AddWindowTool(CWnd* pWnd, LPCTSTR pszText)
{
TOOLINFO ti;
ti.cbSize = sizeof(TOOLINFO);
ti.uFlags = TTF_IDISHWND | TTF_SUBCLASS;
ti.hwnd = pWnd->GetParent()->GetSafeHwnd();
ti.uId = (UINT)pWnd->GetSafeHwnd();
ti.hinst = AfxGetInstanceHandle();
ti.lpszText = (LPTSTR)pszText;
return (BOOL)SendMessage(TTM_ADDTOOL, 0, (LPARAM)&ti);
}
BOOL CMyToolTipCtrl::AddRectTool(CWnd* pWnd, LPCTSTR lpszText, LPCRECT lpRect, UINT nIDTool)
{
TOOLINFO ti;
ti.cbSize = sizeof(TOOLINFO);
ti.uFlags = TTF_SUBCLASS;
ti.hwnd = pWnd->GetSafeHwnd();
ti.uId = nIDTool;
ti.hInst = AfxGetInstanceHandle();
ti.lpszText = (LPTSTR)pszText;
::CopyRect(&ti.rect, lpRect);
return (BOOL)SendMessage(TTM_ADDTOOL, 0, (LPARAM)&ti);
}
动态工具提示:
如在调用AddTool,AddWindowTool,AddRectTool时,给工具提示文本指定了 LPSTRTEXTCALLBACK,工具提示控件会在显示工具提示前给其父窗口发一些通知。
WM_NOTIFY
通知码:TTN_NEEDTEXT
lParam:TOOLTIPTEXT*
typedef struct
{
NMHDR hdr;
LPTSTR lpszText;
char szText[80];
HINSTANCE hinst;
UINT uFlags;
}TOOLTIPTEXT;
ToolTip控件的父窗口可用三种方式响应TTN_NEEDTEXT通知:
1.把文本字符串的地址复制到TOOLTIPTEXT结构的lpszText中。
2.把文本复制到szText。
3.把字符串资源ID给lpszText。把应用实例句柄给hinst。
ON_NOTIFY(TTN_NEEDTEXT, NULL, OnNeedText)
...
BOOL CMyDialog::OnInitDialog()
{
m_ctlTT.Create(this);
m_ctlTT.AddRectTool(this, LPSTR_TEXTCALLBACK, CRect(0, 0, 32, 32), IDT_RECTANGLE);
return TRUE;
}
void CMyDialog::OnNeedText(NMHDR *pnmh, LRESULT *pResult)
{
TOOLTIPTEXT *ptt = (TOOLTIPTEXT*)pnmh;
if(ptt->hdr.idFrom == IDT_RECTANGLE)
{
CString string;
CTime time = CTime::GetCurrentTime();
string.Format(_T("%.2d:%.2d%.2d"), ...);
::lpstrcpy(ptt->szText, (LPCTSTR)string);
}
}
CToolTipCtrl::
GetText
UpdateTipText
SetDelayTime
图像列表和ComboBoxEx控件
CImageList:
为其它控件提供图像,在位图上制造特殊效果。
MFC用三种方式创建图像列表:
1.先创建空的,再用Add在其中添加图像。
2.用含图像数组的位图创建初始化了的图像列表。
3.合并现有图像列表的图像创建初始化了的。
CImageList il;
il.Create(IDB_BITMAP, 18, 1, CLR_NONE);
CImageList::SetBkColor // 让背景色画不出来。
// 在指定DC上显示il中图片
il.Draw(pDC, 2, point, ILD_NORMAL);
m_il.Create(IDB_IMAGE, 16, 1, RGB(255, 0, 255));
m_wndCBEX.SetImageList(&m_il);
for(int i = 0; i < 5; i++)
{
CString string;
string.Format(_T("Item %d"), i);
COMBOBOXEXITEM cbei;
cbei.mask = CBEIF_IMAGE | CBEIF_SELECTEDIMAGE | CBEIF_TEXT;
cbei.iItem = i;
cbei.pszText = (LPTSTR)(LPCTSTR)string;
cbei.iImage = 0;
cbei.iSelectedImage = 0;
m_wndCBEX.InsertItem(&cbei);
}
cbei.iIndent // 指定项目空格数,用于缩进显示。
COMBOBOXEXITEM:
DeleteItem
GetItem
SetItem
CComboBoxEx : public CComboBox
CComboBoxEx还支持几种扩展样式。需用CComboBoxEx::SetExtendedStyle实现。
CComBoBoxEx发给父窗口的CBN通知和传统组合框一样。
还支持自己特有的通知。
CComboBoxEx通知
CBEN_BEGINEDIT 显示下拉列表/单击编辑控件
CBEN_ENDEDIT 在控件列表里选中或编辑控件的文本
CBEN_DRAGBEGIN 在控件中拖动某项
CBEN_INSERTITEM 某项被插入控件
CBEN_DELETEITEM 某项被删除
CBEN_GETDISPINFO
NM_SETCURSOR
进度/动画
CProgressCtrl
m_wndProgress.SetRange
SetPos
OffsetPos
SetStep
StepIt
CAnimateCtrl
Open
Play
Stop
Close
样式:
ACS_AUTOPLAY
ACS_CENTER
ACS_TRANSPARENT
ACS_TIMER
IP地址
CIpAddressCtrl
SetAddress
GetAddress
ClearAddress
IsBlank
// .h
BYTE m_nField1, m_nField2, m_nField3, m_nField4;
// cpp
BOOL CMyDialog::OnInitDialog()
{
CDialog::OnInitDialog();
m_wndIpAddress.SetAddress(m_nField1, m_nField2, m_nField3, m_nField4);
return TRUE;
}
void CMyDialog::OnOK()
{
m_wndIpAddress.GetAddress(m_nField1, m_nField2, m_nField3, m_nField4);
CDialog::OnOK();
}
m_wndIpAddress.SetFieldRange(0, 10, 100);
IP地址控件向其所有者,发四种通知:
WM_COMMAND:
EN_SETFOCUS
EN_KILLFOCUS
EN_CHANGE
WM_NOTIFY:
IDN_FIELDCHANGED