企业官网建设流程全解析

简介：这是一份面向 MFC 初学者与需要在 VS2010 及以上环境中完善对话框界面的开发者的示例工程，围绕普通 Dialog 底部状态栏的创建、分栏配置与动态文本更新展开，可用于帮助提示、系统状态和时间显示等交互场景。压缩包共 47 个文件，约 29.05MB，包含解决方案与工程配置、对话框及状态栏相关头文件和源文件、资源脚本与图标等，并附带调试编译产生的中间文件，便于直接打开对照学习与运行排查。已有 738 人学习，说明该主题在 MFC 界面开发中具有稳定的参考需求。工程重点呈现状态栏对象声明、初始化创建、多面板指示器设置，以及通过定时器刷新窗格文字的实现思路，读者可据此理解 MFC 状态栏从资源布局到代码联动的完整流程，并在此基础上扩展工具提示、自定义图标或单击响应等功能。

1. 对话框程序没有状态栏这件事：先分清裸控件、控制条和自绘三条路

用 MFC 向导建一个 dialog 程序，跑起来就是几个控件摊在窗体上，底部空空如也。有人在资源编辑器里翻半天找状态栏控件，翻不到就以为得把工程改回 SDI，其实给 dialog 加状态栏没那么玄学：本质就是往对话框上挂一个子窗口，再在 WM_SIZE 里把它固定在客户区底部。可选的路有三条——裸的 CStatusBarCtrl、MFC 框架味的 CStatusBar、以及自己画一个。第一条最省心，第二条容易被框架的隐式约定绊住，第三条只在要做异形配色时才值得。这一篇按实际改过的顺序，把三条路的边界、参数和翻车点拆开，适合手上有现成对话框工程、不想重构框架的人。

2. CStatusBarCtrl 落地：Create、SetParts 与 OnSize 的三段代码

先把最稳的一条走通。CStatusBarCtrl 是对 Win32 状态栏公共控件的薄封装，不继承 CControlBar，不依赖框架窗口，父窗口是谁都行，所以放进对话框里没有任何水土不服。它的坑集中在两个地方：分栏参数的语义，以及高度和宽度的重算时机。这两件事搞明白，剩下就是填文本。

2.1 成员变量与 Create 的三个参数

第一步是在对话框类里加成员，而不是在 OnInitDialog 里定义局部变量。状态栏窗口的生命周期必须跟对话框一致，写成局部变量的话函数一返回对象就析构，析构里会调 DestroyWindow，界面上会看到一条闪一下就消失的灰条，调试版还会弹断言。

// MyDlg.h class CMyDlg : public CDialogEx { DECLARE_DYNAMIC(CMyDlg) public: CMyDlg(CWnd* pParent = nullptr); enum { IDD = IDD_MYDLG_DIALOG }; protected: CStatusBarCtrl m_wndStatusBar; // 必须是成员 int m_nBarHeight; // 缓存高度，避免每帧重算字体 void LayoutStatusBar(int cx, int cy); int ScaleForDpi(int n); virtual BOOL OnInitDialog(); afx_msg void OnSize(UINT nType, int cx, int cy); DECLARE_MESSAGE_MAP() };

然后是创建。四个参数分别是样式、初始矩形、父窗口、控件 ID，每一个都有讲究：

BOOL CMyDlg::OnInitDialog() { CDialogEx::OnInitDialog(); // 初始矩形给全零，位置和大小由 LayoutStatusBar 统一决定 if (!m_wndStatusBar.Create(WS_CHILD | WS_VISIBLE | SBARS_SIZEGRIP, CRect(0, 0, 0, 0), this, IDC_STATUSBAR)) { TRACE(_T("状态栏创建失败，先查 ID 是否和别的控件重复\n")); return TRUE; // 创建失败也别 return FALSE，否则对话框直接关掉 } // 分栏：数组里存的是每一栏的“右边界坐标”，最后一栏写 -1 int aParts[3] = { ScaleForDpi(160), ScaleForDpi(320), -1 }; m_wndStatusBar.SetParts(3, aParts); m_nBarHeight = ScaleForDpi(24); CRect rcDlg; GetClientRect(&rcDlg); LayoutStatusBar(rcDlg.Width(), rcDlg.Height()); m_wndStatusBar.SetText(_T("就绪"), 0, SBT_NOBORDERS); m_wndStatusBar.SetText(_T("行 0"), 1, 0); m_wndStatusBar.SetText(_T("列 0"), 2, 0); return TRUE; }

参数逐个说。WS_CHILD | WS_VISIBLE是必须的，少了 VISIBLE 就得自己再 ShowWindow 一次。SBARS_SIZEGRIP是右下角那个斜纹拖拽柄，只有对话框带WS_THICKFRAME（可缩放）时才有意义，固定尺寸的对话框加了反而多一条视觉噪声。父窗口传this，也就是对话框本身，这样状态栏的坐标就是相对对话框客户区的，后面算 y 坐标不用再做转换。ID 一定要挑一个没被占用的值，用资源编辑器里的 IDC_STATUSBAR 或者自己加一个都行，撞了 ID 的表现是GetDlgItem拿到别的控件，很隐蔽。

CRect(0, 0, 0, 0)是故意的：状态栏的高度由字体决定，宽度由布局决定，创建时给什么都不作数，索性给零，等下面统一摆。

2.2 SetParts 的分栏算术：为什么最后一栏必须写 -1

这是整个状态栏里最容易理解错的一个 API。SetParts(int nParts, int* pWidths)的第二个参数不是“每栏多宽”，而是“每栏右边缘在客户区里的 x 坐标”，是一个从 0 开始累加的坐标序列。

举例，传{160, 320, -1}得到的是三栏：第 0 栏从 0 到 160，第 1 栏从 160 到 320，第 2 栏从 320 一路顶到右边界。如果按“宽度”去理解，就会写出{160, 160, 160}这种数组，结果第二栏宽度变成 0，第三栏左边跑到 320 去，界面上看起来就是第一格特别宽、后两格挤成一条线，很多人到这一步开始怀疑是不是控件坏了。

最后一栏写-1是微软留的约定，表示“剩下的全给它”，它会跟着窗口宽度自己伸缩。所以只要对话框可缩放，最后一栏几乎永远应该写 -1，否则拉大窗口后右边会留一块灰色空白，那块空白不属于任何一栏，SetText也写不进去。

中间栏的坐标在窗口尺寸变化后不会自动重算，因为它们是绝对像素。窗口从 800 拉到 1400，第一栏还是 160，比例就全乱了。所以OnSize里要重新调一次SetParts，把坐标按新宽度算：

void CMyDlg::LayoutStatusBar(int cx, int cy) { if (m_wndStatusBar.GetSafeHwnd() == nullptr) return; // 先把自己摆到底部，高度用缓存值 m_wndStatusBar.SetWindowPos(NULL, 0, cy - m_nBarHeight, cx, m_nBarHeight, SWP_NOZORDER | SWP_NOACTIVATE); // 宽度变了，分栏坐标跟着重算：前两栏固定，最后一栏吃掉剩余 int aParts[3]; aParts[0] = ScaleForDpi(160); aParts[1] = cx - ScaleForDpi(120); // 倒数第二栏右边界顶到“距右 120” aParts[2] = -1; if (aParts[1] > aParts[0]) // 窗口被拖得极窄时别把坐标算反 m_wndStatusBar.SetParts(3, aParts); } void CMyDlg::OnSize(UINT nType, int cx, int cy) { CDialogEx::OnSize(nType, cx, cy); if (nType != SIZE_MINIMIZED && m_wndStatusBar.GetSafeHwnd() != nullptr) LayoutStatusBar(cx, cy); }

LayoutStatusBar里的顺序不能反：先SetWindowPos把状态栏拉到目标宽度，再SetParts。反过来的话，SetParts是按当前客户区宽度裁剪的，宽度还没变，算出来的坐标会被截断，表现就是拉大窗口时最后一栏偶尔不跟着长，得再拉一次才对——这种偶发问题最难查。

OnSize里那个SIZE_MINIMIZED判断是必需的。最小化时cx/cy是 0，cy - m_nBarHeight会算成负数，SetWindowPos传负高度虽然不崩，但恢复窗口时会出现一条位置错乱的重影。

2.3 高度的两种算法与 DPI 换算

状态栏该多高？两种做法。

一种是让控件自己算：创建后给它发一条WM_SIZE，状态栏过程会按当前字体重新设置窗口高度，然后GetWindowRect就能拿到真实高度。这种做法省事，但依赖控件内部行为，在某些主题和缩放比例下拿回来还是 0，需要兜底。

另一种是自己按字体算，确定性强，我一般用这个：

int CMyDlg::ScaleForDpi(int n) { HDC hdc = ::GetDC(m_hWnd); int nDpi = hdc ? ::GetDeviceCaps(hdc, LOGPIXELSX) : 96; if (hdc) ::ReleaseDC(m_hWnd, hdc); return MulDiv(n, nDpi, 96); }

MulDiv(n, dpi, 96)是把按 96 DPI 设计的逻辑像素换算成当前屏幕的物理像素。100% 缩放下 dpi 是 96，比例 1:1；150% 缩放下 dpi 是 144，ScaleForDpi(24)返回 36。不换算的后果是状态栏文字被裁掉一半，或者细得像根线，在 4K 屏上尤其明显。

m_nBarHeight只在OnInitDialog里算一次，因为对话框运行期间 DPI 一般不会变。真要做 Per-Monitor 支持，得响应WM_DPICHANGED重算，那是另一档事。

高度定下来之后，底部那块空间必须从其他控件手里扣出来。对话框的OnSize是在控件已经按模板坐标摆好之后才调的，如果你在模板里把某个按钮的底边贴到了对话框底部，状态栏一盖上去正好压住它。常见做法是在OnSize里显式把底部控件往上挪m_nBarHeight，或者干脆在模板里预留出这条带子的高度，后者更省代码也更不容易错。

提示：SetText的第三个参数对第 0 栏建议用SBT_NOBORDERS，这样文字左边不会出现一条竖分隔线，视觉上更像原生的消息栏。

3. 换成 CStatusBar：SetIndicators 依赖的字符串表和 CalcFixedLayout

有些工程已经有一套indicators[]数组和字符串表资源，或者团队里其他模块用的是 CStatusBar，这时候用 CStatusBarCtrl 会显得两套风格并存。CStatusBar 继承自 CControlBar，是给框架窗口设计的，放进对话框不是不能用，但它默认依赖三样东西：字符串表、框架的RecalcLayout、以及GetParentFrame()。对话框一样都不给，得手动补。

3.1 indicators 数组与字符串表资源

CStatusBar 的分栏不靠坐标，靠一个UINT数组加字符串表。数组里每个元素是一个资源 ID，SetIndicators会去字符串表里把这个 ID 对应的文本读出来，作为该栏的默认文字和宽度参考。

// MyDlg.h 文件作用域，不要写在类里面 static UINT indicators[] = { ID_SEPARATOR, // 第 0 栏必须是它，代表“消息栏”，会被自动拉伸 ID_INDICATOR_ROW, // 这三个 ID 必须在字符串表里有对应条目 ID_INDICATOR_COL, ID_INDICATOR_ZOOM };

第 0 栏写ID_SEPARATOR是硬约定。它的样式是SBPS_STRETCH，会吃掉所有剩余宽度，专门用来显示短暂提示（“正在保存…”“已导入 128 条”）。如果第 0 栏换成普通字符串 ID，它会变成一个固定宽度的格子，消息只能挤在那一小块里，后面的栏位也跟着往前挪。

后三个 ID 必须在工程的字符串表里手工建出来。这一步不做，SetIndicators会直接返回 FALSE，状态栏上什么都不显示，界面上就是一条纯灰条，没有任何报错。排查时先看返回值，再看字符串表，别去怀疑代码逻辑。

字符串的内容还会影响栏宽。SetPaneInfo里如果把宽度传 0，控件会按该字符串的文本宽度加边距来定宽，所以给这些 ID 写一个有代表性的文本（比如“行 9999”）比写“行”更合适，避免运行时数字变长被截断。

3.2 用 CalcFixedLayout 补上框架没给的那一步

CStatusBar 的尺寸不是自己算的。框架窗口每次RecalcLayout时会遍历所有控制条，调用它们的CalcFixedLayout得到期望尺寸，再SetWindowPos。对话框没有这套机制，所以创建完之后状态栏就停在创建时的那个零尺寸上，看不见。

补救办法是手动借一次CalcFixedLayout：

BOOL CMyDlg::OnInitDialog() { CDialogEx::OnInitDialog(); if (!m_wndStatusBar.Create(this, WS_CHILD | WS_VISIBLE | CBRS_BOTTOM, AFX_IDW_STATUS_BAR)) return TRUE; if (!m_wndStatusBar.SetIndicators(indicators, _countof(indicators))) { TRACE(_T("SetIndicators 失败，去字符串表确认 ID_INDICATOR_* 是否存在\n")); return TRUE; } m_wndStatusBar.SetPaneInfo(0, ID_SEPARATOR, SBPS_STRETCH, 0); m_wndStatusBar.SetPaneInfo(1, ID_INDICATOR_ROW, SBPS_NORMAL, ScaleForDpi(110)); m_wndStatusBar.SetPaneInfo(2, ID_INDICATOR_COL, SBPS_NORMAL, ScaleForDpi(110)); m_wndStatusBar.SetPaneInfo(3, ID_INDICATOR_ZOOM, SBPS_POPOUT, ScaleForDpi(80)); LayoutStatusBar(); m_wndStatusBar.SetPaneText(0, _T("就绪")); return TRUE; } void CMyDlg::LayoutStatusBar() { if (m_wndStatusBar.GetSafeHwnd() == nullptr) return; CRect rcDlg; GetClientRect(&rcDlg); // 框架里这一步由 RecalcLayout 代劳，对话框里得自己来 CSize sz = m_wndStatusBar.CalcFixedLayout(FALSE, TRUE); m_wndStatusBar.SetWindowPos(NULL, 0, rcDlg.bottom - sz.cy, rcDlg.Width(), sz.cy, SWP_NOZORDER | SWP_NOACTIVATE); }

CalcFixedLayout(FALSE, TRUE)的两个参数分别是“是否拉伸”和“是否水平”。控制条位于底部、只沿水平方向延伸，所以传FALSE, TRUE，返回的CSize里 cy 就是按字体算出来的标准高度，cx 一般不用管。这比硬编码 24 像素靠谱得多，换主题、换 DPI 都能自适应。

SBPS_POPOUT那个样式值得单独提一句：它给格子加一圈内凹边框，视觉上像原生状态栏的“凹陷”效果，只在个别工程里好看，用多了界面会很脏。默认用SBPS_NORMAL就够了。

3.3 SetPaneText、SetPaneInfo 与 ID 的真实关系

新手最容易在这里转不过弯：SetPaneInfo的签名是(int nIndex, UINT nID, UINT nStyle, int cxWidth)，SetPaneText的签名是(int nIndex, LPCTSTR lpszText, BOOL bUpdate)。两个都以索引为准，ID 只是个标识，不会拿它去查找。

所以下面这两种写法语义完全不同，别混：

// 正确：按索引改第 1 栏的文字 m_wndStatusBar.SetPaneText(1, _T("行 128")); // 错误：把 ID_INDICATOR_ROW 的数值当成索引传进去 m_wndStatusBar.SetPaneText(ID_INDICATOR_ROW, _T("行 128"));

ID 的数值一般是从 30000 往上加的，传到SetPaneText里就是越界，函数返回 FALSE，界面毫无变化，日志里也没有任何提示。

另一个隐性依赖是GetParentFrame()。CStatusBar 内部的命令更新（OnUpdateCmdUI）、工具提示、浮动停靠都依赖父框架，在对话框里这个函数返回 NULL，对应的功能全部静默失效。具体表现是：如果你把某个菜单项的 ON_UPDATE_COMMAND_UI 挂到状态栏指示器上，指望它自动刷新文本，那是不会生效的，必须自己在需要的地方调SetPaneText。这一点想清楚了，CStatusBar 在对话框里其实也没那么可怕——它的分栏、样式、渲染都比裸控件舒服。

注意：m_wndStatusBar.Create的样式里加不加CBRS_BOTTOM对对话框没有实际约束力，它只影响控制条自己的对齐意图，真正的定位还是靠SetWindowPos。写上是为了语义清楚，别指望它自动吸底。

4. 往格子里塞进度条：GetRect 时机与子控件父子关系

文本之外，状态栏最常放的两样东西是进度条和临时提示图标。做法都是把目标控件创建成状态栏的子窗口，再摆到指定栏位的矩形里。难点全在“什么时候能拿到正确的矩形”和“销毁顺序”这两个点上。

4.1 GetRect 拿回来全是零的原因

GetItemRect(int nPart, LPRECT lpRect)返回的是某一栏在状态栏客户区坐标下的矩形。它依赖两个前提：栏位已经用SetParts设置过，并且状态栏本身已经有非零的宽度。

在OnInitDialog里刚Create完就调它，会拿到{0,0,0,0}。原因很直接——那一刻状态栏窗口宽度是 0，所有栏位都被裁成零宽。正确的时机是在LayoutStatusBar已经把状态栏SetWindowPos到目标尺寸之后，如果需要更保险，先UpdateWindow()强制跑一次重排。

void CMyDlg::CreateProgressInPane() { if (m_wndStatusBar.GetSafeHwnd() == nullptr) return; CRect rcPane; if (!m_wndStatusBar.GetItemRect(1, &rcPane) || rcPane.IsRectEmpty()) { TRACE(_T("栏位矩形无效：SetParts 调过没有？状态栏宽度是不是还是 0？\n")); return; } rcPane.DeflateRect(ScaleForDpi(2), ScaleForDpi(2)); // 留一点内边距 if (m_wndProgress.GetSafeHwnd() == nullptr) { // 父窗口给状态栏，所以 rcPane 可以直接用，不需要坐标转换 m_wndProgress.Create(WS_CHILD | WS_VISIBLE | PBS_SMOOTH, rcPane, &m_wndStatusBar, IDC_PROGRESS_INBAR); m_wndProgress.SetRange32(0, 100); } else { m_wndProgress.MoveWindow(&rcPane); } }

DeflateRect那两行是视觉上的必需项。不缩进的话进度条会把整个格子填满，紧贴分隔线，看起来像状态栏坏了一块。缩进 2 个逻辑像素、再按 DPI 放大，是最省事的处理。

父窗口传&m_wndStatusBar而不是this，好处是rcPane的坐标系和父窗口客户区完全一致，不用ScreenToClient来回转。传this也能用，但得把矩形从状态栏坐标转到对话框坐标，多一步出错机会。

4.2 销毁顺序：谁先死，谁负责

父窗口是状态栏，意味着对话框销毁时，DestroyWindow会先销毁状态栏，状态栏再连带销毁它的子窗口进度条。这时候m_wndProgress这个 C++ 对象手里的m_hWnd已经是个失效句柄，等对话框对象析构、成员变量逐个析构时，CWnd::~CWnd还会尝试DestroyWindow(m_hWnd)一次。调试版里这通常表现为一句断言，发布版里偶尔是静默失败，偶尔是访问已释放内存。

稳妥的处理是在对话框的OnDestroy里主动拆：

void CMyDlg::OnDestroy() { // 先拆子控件，再让父窗口走 if (m_wndProgress <p> <a href="https://download.csdn.net/download/iworkiwin/9201075" style="color:#ec7500;font-size:14px;"> 本文还有配套的精品资源，点击获取 </a> <img alt="menu-r.4af5f7ec.gif" src="https://csdnimg.cn/release/wenkucmsfe/public/img/menu-r.4af5f7ec.gif" style="width:16px;margin-left:4px;vertical-align:text-bottom;cursor:text;"> </p>