MFC中将CListBox替换为CCheckListBox触发断言失败问题

winctrl3.cpp 第588行的Debug断言触发，核心原因是CCheckListBox作为CListBox的自绘子类，对控件窗口样式有强制要求，仅手动替换控件变量类型不会同步修改控件本身的样式，会直接触发MFC内部的样式校验逻辑。
普通CListBox默认不带自绘相关样式，而CCheckListBox的双击消息处理、复选框绘制逻辑都依赖自绘样式，样式不匹配时就会在OnLButtonDblClk中断言。

• 修改资源控件属性（拖拽资源创建控件的场景）
  打开资源编辑器，定位到对应标签页的列表控件，在属性面板修改以下配置，原有自动排序、滚动条相关配置保持不变即可：
  • 将Owner Draw属性设置为Fixed，对应窗口样式LBS_OWNERDRAWFIXED
  • 开启Has Strings属性，对应窗口样式LBS_HASSTRINGS，该属性必须开启，否则列表项的CString文本无法正常渲染
• 重新绑定控件变量
  不要仅手动修改头文件中的变量声明，建议通过类向导重新绑定：
  1. 打开MFC类向导，找到之前绑定的CListBox类型控件变量，删除原有绑定关系
  2. 重新为该列表控件绑定变量，变量类型选择CCheckListBox，向导会自动更新消息映射、子类化相关的代码，避免手动修改遗漏宏定义导致的异常
• 动态创建场景校验
  如果你的CCheckListBox是通过代码动态创建、而非拖拽资源生成，调用Create方法时必须在样式参数中加入LBS_OWNERDRAWFIXED | LBS_HASSTRINGS，示例代码如下：

  // 原有CListBox创建参数基础上追加两个必填样式即可，LBS_SORT、WS_VSCROLL等原有样式保留
  m_checkList.Create(
      WS_CHILD | WS_VISIBLE | WS_VSCROLL | WS_TABSTOP | LBS_SORT | LBS_NOTIFY | LBS_OWNERDRAWFIXED | LBS_HASSTRINGS,
      listRect, this, IDC_CHECK_LIST
  );
  

修复完成后你原有的列表填充逻辑不需要修改，直接调用AddString即可保留原有行为：

• 字符串自动按字母顺序排序的逻辑和原CListBox完全一致
• 元素数量超出列表可视区域时自动显示垂直滚动条的行为不变
• 后续可以直接调用SetCheck()/GetCheck()方法读写每一项的复选框勾选状态

注意：不要在初始化代码中调用ModifyStyle移除LBS_OWNERDRAWFIXED或LBS_HASSTRINGS样式，否则会再次触发断言或出现列表空白、复选框不显示的问题。

内容的提问来源于stack exchange，提问作者Husam Chekfa