Delphi 11.2中TImageList.Handle返回值超整数范围引发范围检查错误

出现这个问题的核心原因大概率和64位编译下的类型不匹配以及范围检查机制有关，具体分析如下：

• 句柄类型的位数差异：Delphi XE8默认以32位为编译目标，TImageList.Handle返回的是32位句柄值；而Delphi 11.2默认可能是64位编译，此时句柄是64位的HWND类型。如果代码中把这个64位句柄赋值给了Integer（32位）类型的变量，当句柄值超过32位整数最大值（$7FFFFFFF）时，就会触发范围检查错误。即使换成TVirtualImageList，其Handle同样是64位句柄，所以问题依旧。

• 范围检查编译选项的差异：Delphi 11.2默认开启了「范围检查」（Range Checking）编译选项，而XE8中可能未开启。这个选项会严格检查整数赋值时的溢出情况，当64位句柄被强制转换为32位整数时，直接抛出ERangeError。

• 资源文件的兼容性问题（次要）：新版本Delphi对.res资源文件的解析可能有变化，如果.res文件是用旧版本工具生成的，位图资源的格式（比如颜色深度、对齐方式）可能不符合11.2的预期，导致ImageList加载资源后内部状态异常，间接引发Handle获取时的错误。

对应的解决方向 #

1. 修正变量类型：将所有存储句柄的变量类型从Integer改为HWND或THandle，这两个类型是跨32/64位平台兼容的，能适配不同编译架构下的句柄长度。

2. 调整编译选项：如果暂时无法修改代码，可以在项目选项中关闭「范围检查」（路径：Project Options → Compiler → Runtime Errors → 取消勾选Range Checking），但这只是临时 workaround，长期来看还是要修正类型问题。

3. 重新生成资源文件：用Delphi 11.2的资源编译器重新编译你的.res文件，确保资源格式符合新版本要求。或者改用LoadBitmap函数直接加载位图资源，再通过TImageList.Add方法添加到位图列表中，替代直接从res加载的方式。

4. 检查ImageList初始化参数：确认创建TImageList或TVirtualImageList时设置的Width、Height、ColorDepth等参数和位图资源的实际参数匹配，避免因尺寸或颜色深度不兼容导致内部错误。

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