简介TEECHART 8.06 FULL SOURCE 是面向 Delphi、C Builder 等环境的专业图表库完整源码包适用于需要高质量数据可视化、报告导出及深度定制图表行为的开发者。资源共 2362 个文件压缩包 11.49MB其中既有 333 个 pas 源文件和 567 个 dcu 编译单元也包含 229 个 dpk/Delphi 包、dfm/xfm 表单、C Builder 的 cpp/bpk 工程文件以及安装、许可、更新说明等 txt 文档可满足源码学习与工程编译两种需求。已有 183 人浏览学习。该版本重点修正了导出 PDF 时中文乱码的问题适合生成含中文字符的报表和文档同时提供 Kylix/Linux 等相关跨平台工程文件、TeeRecompile 编译工具及决策立方体示例方便在商业智能等场景中快速搭建多维数据看板。借助完整源码开发者既能直接集成到生产项目也能研究图表渲染、坐标体系、序列管理等内部实现为二次开发与性能优化打基础。 有段时间没折腾老控件了前阵子接手一个老项目里面用的是TeeChart 8.06还带完整源码。说实话第一反应是“这玩意儿还用得着研究”但真到动手改图表样式、定制坐标轴、甚至想塞一个自定义渲染逻辑的时候我发现没有源码的TeeChart就是个黑盒改起来处处碰壁。于是我把这套TEECHART 8.06 FULL SOURCE完整翻了底朝天顺便解决了把它从老Delphi环境迁移到Delphi 11的兼容问题。整个过程踩了不少坑但也把TeeChart的绘图内核、源码编译流程、模块依赖关系摸了一遍。这篇就聊聊这套源码里到底有什么、怎么编译、怎么用以及那些文档里查不到的经验。1. 为什么“完整源码版”值得折腾项目背景与适用范围1.1 先搞清楚你拿到的是哪一种TeeChartTeeChart在Delphi/CBuilder圈子里流传的版本形态很多常见的有评估版、安装版、破解绿色版、FULL SOURCE源码版。这几种东西的差别远不止“能不能看到源码”这么简单我整理了一个对照方便你判断手上到底拿的是哪种货。维度评估版二进制安装版FULL SOURCE源码版图表功能受限部分Series类型不可用完整完整修改控件内部逻辑不支持不支持支持多版本IDE适配捆绑固定IDE版本官方提供有限版本可自行编译适配新IDE学习研究价值低低高分发部署有试用水印或限制需按授权部署按授权部署可定制TeeChart 8.06这个版本号大致对应2007-2008年左右的发布周期最早的Steema官方包还保持着比较纯粹的VCL组件风格。它的源码目录里包含VCL、ActiveX、CLX老Delphi的跨平台库等多套封装不像后来TeeChart 2022、2023版本搞那么多跨平台框架。但是反过来看正因为8.06源码结构相对简单它非常适合用来理解TeeChart的底层渲染模型——没有太多云里雾里的抽象层一个Series就是一个类一个Canvas就是一个绘图句柄的封装。1.2 什么样的人需要研究这套源码我个人的经验是如果你只是“拖一个TeeChart控件到窗体上绑定几个字段显示柱状图”那根本不需要FULL SOURCE装个二进制版本就够了。这类用法下源码版反而因为需要自己编译、自己管理IDE库路径增加了不必要的复杂度。但如果你遇到下面这些需求源码版的价值就体现出来了需要定制坐标轴刻度算法比如把科学计数法的刻度格式改成工程单位或者实现非均匀刻度。需要在Canvas底层拦截绘制操作比如把默认的GDI绘制替换成自定义的纹理填充。需要把老控件从Delphi 7/2007迁移到Delphi 11/12而官方已不再提供对应版本的编译包。需要搞清楚一个图表在内存中是怎么存储数据、怎么触发重绘的以便做高性能实时刷新场景。需要修复老版本遗留的Bug比如某些字体在DPI缩放下错位、某些Series在导出图片时丢元素。源码版就像一把“万能钥匙”它不能让你直接变成绘图专家但能让你在遇到问题时多一个解决问题的入口而不是坐在那儿干瞪眼。1.3 授权与合规先谈清楚再动手这里必须先提醒一句TeeChart是商业控件源码版也有对应的授权协议。拿到FULL SOURCE只代表你有权查看和修改源码不代表你可以把源码二次分发或者去掉版权标识。我见过一些项目组把TeeChart源码直接改了一版然后封装成自己的内部组件库这种做法在商业授权上风险很大。如果你只是个人学习、内部工具、或者项目授权允许修改并使用那没问题。但如果你要发布给外部客户务必先确认授权范围。我在实际工作中会把TeeChart相关修改Patch单独归档和业务代码分开管理这样即使后续授权变化也能快速评估影响面。这个话题不展开说但动手前一定得心里有数。2. 这堆源码里到底藏了哪些核心模块2.1 按包文件拆解从TeeCanvas到TeeDB的依赖链拿到TeeChart 8.06 FULL SOURCE打开根目录第一感觉是“很乱”——几十个文件夹、几百个Pascal单元没有清晰说明文件。但看久了就会发现规律整个源码体系按照功能和依赖层级组织核心主线是“绘图引擎 → 图表控件 → 数据层 → 数据库感知 → 设计时支持”。我建议按源码包的编译顺序去读这样最省力。典型的依赖链是这样的TeeProcs最底层的基础工具类包含字符处理、日期处理、数学函数、流读写等公共代码。几乎所有上层单元都会引用它。TeeCanvas绘图抽象层封装了画布、画笔、画刷、字体、图像缓冲。它不直接依赖具体控件而是提供一系列绘制原语。TeeEngine图表核心引擎负责坐标轴计算、Series数据管理、刻度生成、图例布局。这个单元是理解TeeChart工作机理的重中之重。TeeChart控件主体封装TCustomChart、TChart、TChartSeries等类把绘图引擎和VCL的可视化控件连接起来。TeeDB、TeeData数据源接口支持直接绑定TDataSet、TDataSource也支持内存数据列表。TeeUI、TeeDesign设计时编辑器、属性编辑器、图表编辑器窗口等组件主要给IDE设计期用。在源码包中这些对应关系不一定完全按照上面命名有的版本把TeeCanvas里的一部分拆到了TeeDraw3DTeeEngine也可能叫TeeSeries。但只要你把整个引用关系图理顺编译顺序就出来了。我个人习惯是用IDE的Project Manager打开.dpk文件逐个编而不是直接用命令行暴力编——因为老包文件里的依赖顺序经常是错的或者缺漏IDE编译能直接帮你报出缺什么。2.2 值得反复读的几个“宝藏单元”通读全部源码是不现实的也没必要。但有几个单元我建议你花时间啃它们对理解和二次开发特别有用。第一个是TeeCanvas.pas。这个文件包含大量绘图算法尤其是抗锯齿线段、贝塞尔曲线、渐变填充、多边形裁剪等实现。读懂它你就知道TeeChart画的每一根线是拿什么算法勾出来的。很多新人在自定义Series时遇到“画的图形不对”“锯齿严重”“缩放变形”等问题根源都在这里。第二个是TeeSeries.pas。Series是TeeChart的灵魂TeeSeries.pas里定义了从基础类TCustomSeries到柱状图、折线图、面积图、饼图等几乎所有标准Series类型。你去看它的继承关系会发现80%的Series都是从一个基类派生的很多功能比如取最大最小值、计算边界矩形都复用基类逻辑。想新增一个自定义Series类型最快的方式就是找一个最接近的内置Series继承它然后覆写DrawValue和DrawLegend。第三个是TeeProcs.pas。别看它工具类多实际上它定义了TeeChart内部的颜色映射、坐标转换、字符串格式化等基础约定。比如TeeChart怎么把Double类型的坐标值转换成轴上显示的字符串就在这个单元里。搞清楚了你才能自定义出符合自己业务习惯的坐标标签格式。第四个是TeeDB.pas。如果你主要用TeeChart做数据库图表展示这个单元值得了解。它实现了TeeChart与TDataSet字段的自动绑定逻辑理解它之后你在处理字段名变更、运行时动态绑定时会游刃有余。2.3 源码版里那些“看不见”的设计思想读TeeChart源码时最让我佩服的是它的“分层渲染”设计。TeeChart的画图并不是简单地先画背景、再画Series、最后画坐标轴。它内部维护了一个绘制列表Drawing List图表各种元素按层级排序然后统一交给Canvas渲染。这就意味着它可以在绘制过程中动态调整层次关系。比如说你可以让某个Series挂在另一个Series之上这在一般的图表控件里做不到。另一个值得称道的地方是它的坐标轴“计算-绘制”分离。坐标轴的刻度范围、大小标尺、标签位置均先通过算法计算再调用Canvas绘制。这也解释了为什么TeeChart能适应各种极端的缩放比例从几毫秒的时间跨度到几年的跨度它的坐标刻度总是能自动找到合理的步长。源码里对应的方法大概是CalcAxisRanges和DrawAxisLabels这类建议带着“它怎么决定刻度间隔”这个问题去读收获会比泛读大得多。3. 实操把TeeChart 8.06源码搬到Delphi 11环境3.1 为什么迁移老版本TeeChart会碰到一堆问题TeeChart 8.06的年代Delphi还在用ANSI String作为默认字符串类型而Delphi 11已经全面转向Unicode String。PChar、PAnsiChar、PWideChar的混用、旧式流读写、老版本RTTI机制、过时的WinAPI声明……这些都会在编译时爆出一堆问题。除了字符串还有三个常见的坑绘图相关的API声明过旧直接拿Delphi 11的头文件编译经常报错。组件设计期注册代码引用了一些旧IDE的接口需要适配。部分老单元引用了已废弃的System.Win和VCL.Consts里的常量。说白了8.06源码是在WinXP时代的Delphi 7/2007环境下写的要在Delphi 11上跑起来必须做一次“现代化手术”。3.2 编译前准备库路径、环境变量、包顺序动手编译前先把环境理顺。我的建议是复制一份源码到独立目录不要放到Program Files下面也别直接改原始安装包里的那份因为后面改错了能随时回退。比如放入D:\Dev\TeeChart806FullSrc。然后打开Delphi 11在Tools Options Language Delphi Library中把源码目录下的Source路径加入Library Path。需要注意别把整个源码目录都加进去只需要加包含.pas文件的子目录。TeeChart源码里有些目录放Demo、有些放Help、有些放第三方支持把这些都加进Library Path会影响编译速度还可能引入意想不到的冲突。编译顺序我建议从最底层开始逐个编译这些包文件具体文件名可能因发布版本而略有差异但规律一致TeeProcs包运行时基础包TeeCanvas包绘图引擎包TeeEngine包图表引擎包TeeChart运行时包TeeDB包数据库支持各个设计期包每一次编译都可能报错遇到报错先不要慌看是源码问题还是环境问题。源码问题的典型特征是编译器定位到某个.pas里的某一行给出“Undefined type”“Incompatible types”之类的信息环境问题的典型特征是找不到某个.dcu或者.bpl这通常是Library Path没配好。3.3 处理Unicode和旧API调用的典型修改在Delphi 11下编译TeeChart 8.06大概率会撞上几类编译错误这里总结一下我用到的常用修改手段都是相对安全的局部调整。第一类字符串类型不匹配。老代码喜欢写var S: string;但在某些内部函数里却用PChar(S)转成指针给WinAPI用。Win32 API在Ansi时代和Unicode时代函数名有A/W后缀直接传PChar大概率编译不通过或运行乱码。这种情况我会看具体情况如果是给老式控件发消息改成PChar(PAnsiChar(AnsiString(S)))如果是调用新版API就改PWideChar(S)。千万别看到一个错就全局替换因为TeeChart内部有些地方其实是故意用ANSI处理文件流的全局替换会引发更多怪问题。第二类旧式RTTI函数。TeeChart 8.06用了不少GetTypeInfo、GetPropInfo这类老RTTI函数在Delphi 11的默认编译选项下可能无法直接访问需要引入System.TypInfo或者改成新式的TValue方式。但改动范围大我建议尽量保持老代码风格只把缺少的单元引入、把原函数正确的接口类型声明补齐。第三类绘图API的参数类型。比如SelectObject、BitBlt这些函数在30年前的Pascal声明里可能用的是HDC而新代码用HDC别名也没变化但部分句柄类型被重定义过比如HPEN在老代码里可能是THandle新版本里是HPEN类型赋值给THandle会报“Incompatible types”。解决办法是把声明统一为正确的Windows类型或者加一个显式强制转换即THandle(PenHandle)。这些修改本身不难难点在于识别“哪些地方需要动、哪些地方不能动”。我的经验是编译报错的地方必须动但报错“附近”的代码要谨慎一次只改一个错误重新编译再继续别想着一次性改完。老源码的耦合度比现代代码高得多改一处可能带出三处新问题。3.4 安装设计期包并在IDE里验证编译完运行时包后接下来要编译并安装设计期包。设计期包的作用是让TeeChart组件出现在IDE的组件面板上方便拖放使用。操作方式是在Delphi 11中打开设计期包比如TeeChartD9.dpk之类的文件然后在Project Manager里右键选择“Install”或者在菜单Components Install Packages里手动添加编译好的.bpl文件。这里有个细节如果运行时包和设计期包的版本号跟IDE不匹配安装后组件面板上可能看不到任何组件甚至IDE直接崩溃。遇到这种情况先检查“About”信息里显示的包版本再到编译好的.bpl文件的文件属性里确认版本。TeeChart 8.06的版本号通常是8.06而Delphi 11能识别的最低兼容版本可能并不介意但包描述里的IDE版本信息最好改一下。我自己的做法是在安装前把包里的Requires重新编译一遍保证所有依赖都是当前IDE编译的版本避免“不同IDE版本编译的包混装”这种经典坑。安装成功后新建一个VCL工程拖一个TChart到窗体右侧的Series编辑器应该能正常弹出能添加柱状图、折线图、饼图等。如果能做到这一步说明运行时和设计时都通了。接下来再去设置Series的数据源绑定数据库或者内存列表验证能否正常显示。4. 常见问题与排查技巧实录4.1 高频编译错误与处理方案速查我在迁移过程中遇到的报错数量不少但种类其实比较集中。整理了一个速查表供你遇到类似问题时快速定位。报错现象常见原因处理方式File not found: System.Win.Types.dcu老源码引用了过时的单元名在新Delphi中用Winapi.Windows替换或补充引用Incompatible types: string and PChar字符串参数类型不匹配按具体场景转PChar或PWideChar避免全局替换Missing TeeConst.dcu库路径未配置完整把源码Source目录按依赖顺序加入Library PathCannot load package ... It contains unit ... which is also contained in package同一个单元被多个包重复编译检查.dpk的Contains列表将公共单元拆分到运行时包Class TCustomChart not found设计期包安装顺序错误先装运行时包再装设计期包确认包顺序[dcc32 Error] ... E2003 Undeclared identifier: AnsiPos老代码用了旧辅助函数换成System.AnsiStrings中的函数或改用PosBar chart appears blank at runtime绘图初始化未执行或数据源未绑定检查Series.DataSource和Series.XValues/YValues赋值顺序Font size difference between design time and runtime老版本字体坐标系与DPI处理有关手动设置字体的PixelsPerInch或调整DPI自适应逻辑4.2 排错思路不要只见树木不见森林编译报错最忌讳的就是“看到一个错改一个错然后重新编译看下一个”。TeeChart这种老源码的错误往往是连环的很多错误都是同一个原因引发的连锁反应比如一个单元里的类型定义不兼容导致引用它的几十个单元全部爆红。如果一开始就零敲碎打地改后面很容易把源码改得面目全非。我的做法是先看第一批报错集中在哪些文件。如果报错全部来自某一个基础单元比如TeeProcs.pas那就先单独编译这个单元把它彻底修复干净再把其它报错文件加进来。如果报错分布零散但错误类型大致相同比如都是字符串类型问题那就先用搜索功能把所有同类代码定位出来分类处理。还有一个小技巧编译时把IDE的Build配置调成Debug报错信息会包含更详细的源码路径信息方便快速定位。Release配置下可能把优化器打开某些源码问题会被掩盖编译错误信息也不够直观。4.3 运行时常见视觉问题源码编译通过、IDE里能拖控件之后不代表万事大吉。我遇到过几个很典型的运行时问题图表在主窗体显示正常但嵌入到Frame里就空白。这个问题多半是Frame的创建时机问题TeeChart没有收到正确的Parent和Bounds信息需要在Frame的OnResize或OnShow事件里强制Chart.Repaint。导出为PNG时出现黑色背景。这是因为TeeChart 8.06的导出模块对透明背景支持不佳需要在导出前把Chart的Color设为白色或者直接设置Bitmap.Transparent : False。多显示器DPI缩放时图表整体布局错乱。这个问题在新Delphi里比较明显因为TeeChart 8.06内部大量使用绝对像素坐标对高DPI支持不好。我当时的处理方法是给Chart的OnAfterDraw回调加一个缩放比例但这个方法只适合自己二次开发的人普通用户可能只能暂时关闭程序的DPI感知。5. 实际操作中的几个独家心得编译完TeeChart 8.06 FULL SOURCE并在Delphi 11里跑通之后我有一段时间特别“膨胀”感觉什么图都能自己定制了。但用得越多越发现源码在手确实方便却也藏着一个陷阱太容易陷入“二次开发”的深渊。比如你想给柱状图加一个顶部的数字标签源码里改起来确实不难只需要覆写Series的DrawValue方法。但如果你改的是TeeChart源码库里公共的柱状图Series那么你项目里所有用到柱状图的地方都会受影响很可能顺带把别的界面也改了。所以我的习惯是能用子类覆写解决的绝不动源码必须要动源码的一律通过条件编译指令{$IFDEF CUSTOM_TEE}包起来方便后续和官方新版对比、合并。另一个心得是TeeChart 8.06的Demo工程其实是一个质量很高的学习资源。源码包里通常自带一个大而全的Demo项目几乎覆盖了所有Series类型、坐标轴样式、导出方式。我在迁移过程中把Demo项目也编译了一遍不仅帮我快速验证控件是否工作正常而且里面很多代码片段可以直接抄。最后说说版本管理。TeeChart 8.06源码改动之后强烈建议同步维护一个Patch说明文档记录每一处修改的原因、修改日期、修改人。不然时隔半年再打开项目你会完全想不起来某一行强制转换是干嘛用的。我甚至给自己定了一个规矩任何对第三方源码的修改提交代码时必须在Commit Message里带一个TC8-FIX前缀这样后来回溯的时候用git log就能筛选出所有改动点。如果你手头也有一套TeeChart 8.06 FULL SOURCE我的建议是先别急着改功能先花一个下午把源码包里的目录结构、包依赖关系梳理清楚对照我上面说的几个核心单元读一遍再决定要不要动刀。这个底子打好了后面无论是迁移到新IDE、接新业务还是自己扩展Series类型都会顺手很多。本文还有配套的精品资源点击获取
TeeChart 8.06完整源码解析：从Delphi老项目迁移到图表定制开发
简介TEECHART 8.06 FULL SOURCE 是面向 Delphi、C Builder 等环境的专业图表库完整源码包适用于需要高质量数据可视化、报告导出及深度定制图表行为的开发者。资源共 2362 个文件压缩包 11.49MB其中既有 333 个 pas 源文件和 567 个 dcu 编译单元也包含 229 个 dpk/Delphi 包、dfm/xfm 表单、C Builder 的 cpp/bpk 工程文件以及安装、许可、更新说明等 txt 文档可满足源码学习与工程编译两种需求。已有 183 人浏览学习。该版本重点修正了导出 PDF 时中文乱码的问题适合生成含中文字符的报表和文档同时提供 Kylix/Linux 等相关跨平台工程文件、TeeRecompile 编译工具及决策立方体示例方便在商业智能等场景中快速搭建多维数据看板。借助完整源码开发者既能直接集成到生产项目也能研究图表渲染、坐标体系、序列管理等内部实现为二次开发与性能优化打基础。 有段时间没折腾老控件了前阵子接手一个老项目里面用的是TeeChart 8.06还带完整源码。说实话第一反应是“这玩意儿还用得着研究”但真到动手改图表样式、定制坐标轴、甚至想塞一个自定义渲染逻辑的时候我发现没有源码的TeeChart就是个黑盒改起来处处碰壁。于是我把这套TEECHART 8.06 FULL SOURCE完整翻了底朝天顺便解决了把它从老Delphi环境迁移到Delphi 11的兼容问题。整个过程踩了不少坑但也把TeeChart的绘图内核、源码编译流程、模块依赖关系摸了一遍。这篇就聊聊这套源码里到底有什么、怎么编译、怎么用以及那些文档里查不到的经验。1. 为什么“完整源码版”值得折腾项目背景与适用范围1.1 先搞清楚你拿到的是哪一种TeeChartTeeChart在Delphi/CBuilder圈子里流传的版本形态很多常见的有评估版、安装版、破解绿色版、FULL SOURCE源码版。这几种东西的差别远不止“能不能看到源码”这么简单我整理了一个对照方便你判断手上到底拿的是哪种货。维度评估版二进制安装版FULL SOURCE源码版图表功能受限部分Series类型不可用完整完整修改控件内部逻辑不支持不支持支持多版本IDE适配捆绑固定IDE版本官方提供有限版本可自行编译适配新IDE学习研究价值低低高分发部署有试用水印或限制需按授权部署按授权部署可定制TeeChart 8.06这个版本号大致对应2007-2008年左右的发布周期最早的Steema官方包还保持着比较纯粹的VCL组件风格。它的源码目录里包含VCL、ActiveX、CLX老Delphi的跨平台库等多套封装不像后来TeeChart 2022、2023版本搞那么多跨平台框架。但是反过来看正因为8.06源码结构相对简单它非常适合用来理解TeeChart的底层渲染模型——没有太多云里雾里的抽象层一个Series就是一个类一个Canvas就是一个绘图句柄的封装。1.2 什么样的人需要研究这套源码我个人的经验是如果你只是“拖一个TeeChart控件到窗体上绑定几个字段显示柱状图”那根本不需要FULL SOURCE装个二进制版本就够了。这类用法下源码版反而因为需要自己编译、自己管理IDE库路径增加了不必要的复杂度。但如果你遇到下面这些需求源码版的价值就体现出来了需要定制坐标轴刻度算法比如把科学计数法的刻度格式改成工程单位或者实现非均匀刻度。需要在Canvas底层拦截绘制操作比如把默认的GDI绘制替换成自定义的纹理填充。需要把老控件从Delphi 7/2007迁移到Delphi 11/12而官方已不再提供对应版本的编译包。需要搞清楚一个图表在内存中是怎么存储数据、怎么触发重绘的以便做高性能实时刷新场景。需要修复老版本遗留的Bug比如某些字体在DPI缩放下错位、某些Series在导出图片时丢元素。源码版就像一把“万能钥匙”它不能让你直接变成绘图专家但能让你在遇到问题时多一个解决问题的入口而不是坐在那儿干瞪眼。1.3 授权与合规先谈清楚再动手这里必须先提醒一句TeeChart是商业控件源码版也有对应的授权协议。拿到FULL SOURCE只代表你有权查看和修改源码不代表你可以把源码二次分发或者去掉版权标识。我见过一些项目组把TeeChart源码直接改了一版然后封装成自己的内部组件库这种做法在商业授权上风险很大。如果你只是个人学习、内部工具、或者项目授权允许修改并使用那没问题。但如果你要发布给外部客户务必先确认授权范围。我在实际工作中会把TeeChart相关修改Patch单独归档和业务代码分开管理这样即使后续授权变化也能快速评估影响面。这个话题不展开说但动手前一定得心里有数。2. 这堆源码里到底藏了哪些核心模块2.1 按包文件拆解从TeeCanvas到TeeDB的依赖链拿到TeeChart 8.06 FULL SOURCE打开根目录第一感觉是“很乱”——几十个文件夹、几百个Pascal单元没有清晰说明文件。但看久了就会发现规律整个源码体系按照功能和依赖层级组织核心主线是“绘图引擎 → 图表控件 → 数据层 → 数据库感知 → 设计时支持”。我建议按源码包的编译顺序去读这样最省力。典型的依赖链是这样的TeeProcs最底层的基础工具类包含字符处理、日期处理、数学函数、流读写等公共代码。几乎所有上层单元都会引用它。TeeCanvas绘图抽象层封装了画布、画笔、画刷、字体、图像缓冲。它不直接依赖具体控件而是提供一系列绘制原语。TeeEngine图表核心引擎负责坐标轴计算、Series数据管理、刻度生成、图例布局。这个单元是理解TeeChart工作机理的重中之重。TeeChart控件主体封装TCustomChart、TChart、TChartSeries等类把绘图引擎和VCL的可视化控件连接起来。TeeDB、TeeData数据源接口支持直接绑定TDataSet、TDataSource也支持内存数据列表。TeeUI、TeeDesign设计时编辑器、属性编辑器、图表编辑器窗口等组件主要给IDE设计期用。在源码包中这些对应关系不一定完全按照上面命名有的版本把TeeCanvas里的一部分拆到了TeeDraw3DTeeEngine也可能叫TeeSeries。但只要你把整个引用关系图理顺编译顺序就出来了。我个人习惯是用IDE的Project Manager打开.dpk文件逐个编而不是直接用命令行暴力编——因为老包文件里的依赖顺序经常是错的或者缺漏IDE编译能直接帮你报出缺什么。2.2 值得反复读的几个“宝藏单元”通读全部源码是不现实的也没必要。但有几个单元我建议你花时间啃它们对理解和二次开发特别有用。第一个是TeeCanvas.pas。这个文件包含大量绘图算法尤其是抗锯齿线段、贝塞尔曲线、渐变填充、多边形裁剪等实现。读懂它你就知道TeeChart画的每一根线是拿什么算法勾出来的。很多新人在自定义Series时遇到“画的图形不对”“锯齿严重”“缩放变形”等问题根源都在这里。第二个是TeeSeries.pas。Series是TeeChart的灵魂TeeSeries.pas里定义了从基础类TCustomSeries到柱状图、折线图、面积图、饼图等几乎所有标准Series类型。你去看它的继承关系会发现80%的Series都是从一个基类派生的很多功能比如取最大最小值、计算边界矩形都复用基类逻辑。想新增一个自定义Series类型最快的方式就是找一个最接近的内置Series继承它然后覆写DrawValue和DrawLegend。第三个是TeeProcs.pas。别看它工具类多实际上它定义了TeeChart内部的颜色映射、坐标转换、字符串格式化等基础约定。比如TeeChart怎么把Double类型的坐标值转换成轴上显示的字符串就在这个单元里。搞清楚了你才能自定义出符合自己业务习惯的坐标标签格式。第四个是TeeDB.pas。如果你主要用TeeChart做数据库图表展示这个单元值得了解。它实现了TeeChart与TDataSet字段的自动绑定逻辑理解它之后你在处理字段名变更、运行时动态绑定时会游刃有余。2.3 源码版里那些“看不见”的设计思想读TeeChart源码时最让我佩服的是它的“分层渲染”设计。TeeChart的画图并不是简单地先画背景、再画Series、最后画坐标轴。它内部维护了一个绘制列表Drawing List图表各种元素按层级排序然后统一交给Canvas渲染。这就意味着它可以在绘制过程中动态调整层次关系。比如说你可以让某个Series挂在另一个Series之上这在一般的图表控件里做不到。另一个值得称道的地方是它的坐标轴“计算-绘制”分离。坐标轴的刻度范围、大小标尺、标签位置均先通过算法计算再调用Canvas绘制。这也解释了为什么TeeChart能适应各种极端的缩放比例从几毫秒的时间跨度到几年的跨度它的坐标刻度总是能自动找到合理的步长。源码里对应的方法大概是CalcAxisRanges和DrawAxisLabels这类建议带着“它怎么决定刻度间隔”这个问题去读收获会比泛读大得多。3. 实操把TeeChart 8.06源码搬到Delphi 11环境3.1 为什么迁移老版本TeeChart会碰到一堆问题TeeChart 8.06的年代Delphi还在用ANSI String作为默认字符串类型而Delphi 11已经全面转向Unicode String。PChar、PAnsiChar、PWideChar的混用、旧式流读写、老版本RTTI机制、过时的WinAPI声明……这些都会在编译时爆出一堆问题。除了字符串还有三个常见的坑绘图相关的API声明过旧直接拿Delphi 11的头文件编译经常报错。组件设计期注册代码引用了一些旧IDE的接口需要适配。部分老单元引用了已废弃的System.Win和VCL.Consts里的常量。说白了8.06源码是在WinXP时代的Delphi 7/2007环境下写的要在Delphi 11上跑起来必须做一次“现代化手术”。3.2 编译前准备库路径、环境变量、包顺序动手编译前先把环境理顺。我的建议是复制一份源码到独立目录不要放到Program Files下面也别直接改原始安装包里的那份因为后面改错了能随时回退。比如放入D:\Dev\TeeChart806FullSrc。然后打开Delphi 11在Tools Options Language Delphi Library中把源码目录下的Source路径加入Library Path。需要注意别把整个源码目录都加进去只需要加包含.pas文件的子目录。TeeChart源码里有些目录放Demo、有些放Help、有些放第三方支持把这些都加进Library Path会影响编译速度还可能引入意想不到的冲突。编译顺序我建议从最底层开始逐个编译这些包文件具体文件名可能因发布版本而略有差异但规律一致TeeProcs包运行时基础包TeeCanvas包绘图引擎包TeeEngine包图表引擎包TeeChart运行时包TeeDB包数据库支持各个设计期包每一次编译都可能报错遇到报错先不要慌看是源码问题还是环境问题。源码问题的典型特征是编译器定位到某个.pas里的某一行给出“Undefined type”“Incompatible types”之类的信息环境问题的典型特征是找不到某个.dcu或者.bpl这通常是Library Path没配好。3.3 处理Unicode和旧API调用的典型修改在Delphi 11下编译TeeChart 8.06大概率会撞上几类编译错误这里总结一下我用到的常用修改手段都是相对安全的局部调整。第一类字符串类型不匹配。老代码喜欢写var S: string;但在某些内部函数里却用PChar(S)转成指针给WinAPI用。Win32 API在Ansi时代和Unicode时代函数名有A/W后缀直接传PChar大概率编译不通过或运行乱码。这种情况我会看具体情况如果是给老式控件发消息改成PChar(PAnsiChar(AnsiString(S)))如果是调用新版API就改PWideChar(S)。千万别看到一个错就全局替换因为TeeChart内部有些地方其实是故意用ANSI处理文件流的全局替换会引发更多怪问题。第二类旧式RTTI函数。TeeChart 8.06用了不少GetTypeInfo、GetPropInfo这类老RTTI函数在Delphi 11的默认编译选项下可能无法直接访问需要引入System.TypInfo或者改成新式的TValue方式。但改动范围大我建议尽量保持老代码风格只把缺少的单元引入、把原函数正确的接口类型声明补齐。第三类绘图API的参数类型。比如SelectObject、BitBlt这些函数在30年前的Pascal声明里可能用的是HDC而新代码用HDC别名也没变化但部分句柄类型被重定义过比如HPEN在老代码里可能是THandle新版本里是HPEN类型赋值给THandle会报“Incompatible types”。解决办法是把声明统一为正确的Windows类型或者加一个显式强制转换即THandle(PenHandle)。这些修改本身不难难点在于识别“哪些地方需要动、哪些地方不能动”。我的经验是编译报错的地方必须动但报错“附近”的代码要谨慎一次只改一个错误重新编译再继续别想着一次性改完。老源码的耦合度比现代代码高得多改一处可能带出三处新问题。3.4 安装设计期包并在IDE里验证编译完运行时包后接下来要编译并安装设计期包。设计期包的作用是让TeeChart组件出现在IDE的组件面板上方便拖放使用。操作方式是在Delphi 11中打开设计期包比如TeeChartD9.dpk之类的文件然后在Project Manager里右键选择“Install”或者在菜单Components Install Packages里手动添加编译好的.bpl文件。这里有个细节如果运行时包和设计期包的版本号跟IDE不匹配安装后组件面板上可能看不到任何组件甚至IDE直接崩溃。遇到这种情况先检查“About”信息里显示的包版本再到编译好的.bpl文件的文件属性里确认版本。TeeChart 8.06的版本号通常是8.06而Delphi 11能识别的最低兼容版本可能并不介意但包描述里的IDE版本信息最好改一下。我自己的做法是在安装前把包里的Requires重新编译一遍保证所有依赖都是当前IDE编译的版本避免“不同IDE版本编译的包混装”这种经典坑。安装成功后新建一个VCL工程拖一个TChart到窗体右侧的Series编辑器应该能正常弹出能添加柱状图、折线图、饼图等。如果能做到这一步说明运行时和设计时都通了。接下来再去设置Series的数据源绑定数据库或者内存列表验证能否正常显示。4. 常见问题与排查技巧实录4.1 高频编译错误与处理方案速查我在迁移过程中遇到的报错数量不少但种类其实比较集中。整理了一个速查表供你遇到类似问题时快速定位。报错现象常见原因处理方式File not found: System.Win.Types.dcu老源码引用了过时的单元名在新Delphi中用Winapi.Windows替换或补充引用Incompatible types: string and PChar字符串参数类型不匹配按具体场景转PChar或PWideChar避免全局替换Missing TeeConst.dcu库路径未配置完整把源码Source目录按依赖顺序加入Library PathCannot load package ... It contains unit ... which is also contained in package同一个单元被多个包重复编译检查.dpk的Contains列表将公共单元拆分到运行时包Class TCustomChart not found设计期包安装顺序错误先装运行时包再装设计期包确认包顺序[dcc32 Error] ... E2003 Undeclared identifier: AnsiPos老代码用了旧辅助函数换成System.AnsiStrings中的函数或改用PosBar chart appears blank at runtime绘图初始化未执行或数据源未绑定检查Series.DataSource和Series.XValues/YValues赋值顺序Font size difference between design time and runtime老版本字体坐标系与DPI处理有关手动设置字体的PixelsPerInch或调整DPI自适应逻辑4.2 排错思路不要只见树木不见森林编译报错最忌讳的就是“看到一个错改一个错然后重新编译看下一个”。TeeChart这种老源码的错误往往是连环的很多错误都是同一个原因引发的连锁反应比如一个单元里的类型定义不兼容导致引用它的几十个单元全部爆红。如果一开始就零敲碎打地改后面很容易把源码改得面目全非。我的做法是先看第一批报错集中在哪些文件。如果报错全部来自某一个基础单元比如TeeProcs.pas那就先单独编译这个单元把它彻底修复干净再把其它报错文件加进来。如果报错分布零散但错误类型大致相同比如都是字符串类型问题那就先用搜索功能把所有同类代码定位出来分类处理。还有一个小技巧编译时把IDE的Build配置调成Debug报错信息会包含更详细的源码路径信息方便快速定位。Release配置下可能把优化器打开某些源码问题会被掩盖编译错误信息也不够直观。4.3 运行时常见视觉问题源码编译通过、IDE里能拖控件之后不代表万事大吉。我遇到过几个很典型的运行时问题图表在主窗体显示正常但嵌入到Frame里就空白。这个问题多半是Frame的创建时机问题TeeChart没有收到正确的Parent和Bounds信息需要在Frame的OnResize或OnShow事件里强制Chart.Repaint。导出为PNG时出现黑色背景。这是因为TeeChart 8.06的导出模块对透明背景支持不佳需要在导出前把Chart的Color设为白色或者直接设置Bitmap.Transparent : False。多显示器DPI缩放时图表整体布局错乱。这个问题在新Delphi里比较明显因为TeeChart 8.06内部大量使用绝对像素坐标对高DPI支持不好。我当时的处理方法是给Chart的OnAfterDraw回调加一个缩放比例但这个方法只适合自己二次开发的人普通用户可能只能暂时关闭程序的DPI感知。5. 实际操作中的几个独家心得编译完TeeChart 8.06 FULL SOURCE并在Delphi 11里跑通之后我有一段时间特别“膨胀”感觉什么图都能自己定制了。但用得越多越发现源码在手确实方便却也藏着一个陷阱太容易陷入“二次开发”的深渊。比如你想给柱状图加一个顶部的数字标签源码里改起来确实不难只需要覆写Series的DrawValue方法。但如果你改的是TeeChart源码库里公共的柱状图Series那么你项目里所有用到柱状图的地方都会受影响很可能顺带把别的界面也改了。所以我的习惯是能用子类覆写解决的绝不动源码必须要动源码的一律通过条件编译指令{$IFDEF CUSTOM_TEE}包起来方便后续和官方新版对比、合并。另一个心得是TeeChart 8.06的Demo工程其实是一个质量很高的学习资源。源码包里通常自带一个大而全的Demo项目几乎覆盖了所有Series类型、坐标轴样式、导出方式。我在迁移过程中把Demo项目也编译了一遍不仅帮我快速验证控件是否工作正常而且里面很多代码片段可以直接抄。最后说说版本管理。TeeChart 8.06源码改动之后强烈建议同步维护一个Patch说明文档记录每一处修改的原因、修改日期、修改人。不然时隔半年再打开项目你会完全想不起来某一行强制转换是干嘛用的。我甚至给自己定了一个规矩任何对第三方源码的修改提交代码时必须在Commit Message里带一个TC8-FIX前缀这样后来回溯的时候用git log就能筛选出所有改动点。如果你手头也有一套TeeChart 8.06 FULL SOURCE我的建议是先别急着改功能先花一个下午把源码包里的目录结构、包依赖关系梳理清楚对照我上面说的几个核心单元读一遍再决定要不要动刀。这个底子打好了后面无论是迁移到新IDE、接新业务还是自己扩展Series类型都会顺手很多。本文还有配套的精品资源点击获取
)
