简介:本资源是面向Delphi开发者(尤其适配Delphi 12.3版本)的跨平台UI控件套件TMS FNC UI Pack v6.2.0.0,专为构建高性能、高一致性桌面与移动应用界面提供原生支持。包内含2000个文件,涵盖556个Pascal源码(.pas)、163个Delphi项目文件(.dproj)、87个窗体定义(.dfm)、67个FireMonkey界面文件(.fmx)、158个图标(.ico)及大量资源文件(.res/.jpg/.svg),完整覆盖组件源码、示例工程、资源素材与部署配置,便于深度定制与快速集成。资源大小为29.85MB,结构规范,支持VCL/FMX双框架开发,适合中高级Delphi工程师进行企业级UI重构或新项目开发。目前已有55人学习下载,用户可直接复用全部示例工程、调试组件行为、参考标准资源组织方式,并借助配套脚本(如movefiles.bat)实现自动化部署准备。 前阵子帮客户做一套仓储管理系统的客户端,需求很直白:Windows桌面上要跑一个信息录入端,仓库里用安卓PDA扫码枪做入库出库,两边的界面视觉上要保持一致。做过Delphi的人都知道,Windows桌面大多数人绕不开VCL,安卓端只能用FireMonkey,于是同一个查询列表界面,我得在VCL里用TStringGrid实现一遍,到FMX里再用TGrid重写一遍,字段、事件、样式全部重新对一遍,改个字段名都要跑两个工程。这种来回重复的维护让我实在忍不住,认真试了试TMS FNC UI Pack v6.2.0.0,结果发现原来跨VCL和FMX的UI层真的可以做到只写一遍。这篇文章就围绕这套控件,聊聊FNC是怎么解决跨框架问题的、安装步骤里有哪些坑、核心控件怎么用,以及我在Delphi 12.3真机调试中记录下来的几个典型问题。
1. 一套UI两处部署:跨框架需求把我推到了FNC
先说结论:FNC并不是某个单一控件的名称,而是一整套“框架中立组件”的统称,全称是Framework Neutral Components。TMS把这个系列做成了一个庞大的组件家族,里面包含表格、列表、树、日历、组合框、富文本编辑器、仪表盘、进度条等常用UI组件,覆盖了日常桌面和移动端界面开发的大部分场景。
1.1 FNC和普通VCL/FMX控件的本质区别
传统VCL控件是围绕Windows窗口句柄设计的,底层依赖Win32 API,离开Windows就谈不上工作。FMX控件虽然跨平台,但它和VCL的类体系完全不同,同一功能的控件在两边名称都不一样,比如VCL里的TStringGrid,到FMX里是TGrid,属性事件差异还不小,迁移基本等于重写。
FNC组件走的是另一条路:它不依赖VCL或FMX的基础控件类,而是用Canvas自己绘制所有界面元素。这意味着同一个TTMSFNCGrid,放到VCL窗体里能用,放到FMX窗体里也能用,放到LCL甚至TMS WEB Core里还可以用。控件不创建原生窗口,显示效果完全由TMS的绘制代码决定,所以你在Windows上看到的样子,到Android上基本也是那个样子,不会因为平台不同而出现渲染差异。
这种设计的代价也很明显:组件渲染不再借用操作系统原生控件,所以复杂场景下的绘制开销要自己买单。表格里有几千行数据时如果没开虚拟化,滚动起来会有肉眼可见的卡顿。这一点我在后面专门写一节。
1.2 从维护两套界面到维护一套界面的实际转变
我手头的项目里有个最典型的场景:库存查询页。老方案是VCL版用TStringGrid加一堆TLabel和TButton,FMX版用TGrid加TLabel和TButton,两边写完之后还要为PDA的小屏幕单独调布局,相当于维护三份代码。
换成TMS FNC之后,我直接拖了一个TTMSFNCGrid到窗体上,键头、序号列、筛选行、单元格颜色这些都是组件自带能力,不需要我在外面拼Label和Edit再去做筛选逻辑。更关键的是,同样的.pas窗体文件,我复制出一个VCL版本工程,把创建的窗体基类改一下,控件不用换,运行起来界面一致。
这个替换过程不是理论上的“应该行”,我实际这么干过。老项目里大量使用TButton、TEdit、TLabel的地方,FNC也有对应的TMSFNCButton、TMSFNCEdit、TMSFNCLabel,事件模型都有对应的替代,改起来不用太痛苦。所以如果你手头有项目正面临VCL和FMX两套界面维护的问题,FNC值得认真评估一次。
2. 安装注册和第一个跨平台Demo的完整过程
2.1 安装前必须先做的版本匹配检查
TMS的控件安装包通常以压缩包形式分发,比如v6.2.0.0这个版本,解压rar之后里面就是标准的安装向导。但解压完不要急着双击exe,先花两分钟做下面几项检查,能少走很多弯路。
| 检查项 | 具体要求 |
|---|---|
| Delphi版本 | 确认RAD Studio是12.3,安装向导才能识别对应IDE版本 |
| 旧版FNC组件 | 如果装过更早的TMS FNC系列,先到Control Panel卸载干净,避免BPL包冲突 |
| IDE运行状态 | 安装前一定关闭全部RAD Studio实例,组件注册需要独占文件 |
| 权限 | Windows上右键以管理员身份运行安装程序,避免Registry写入失败 |
| 授权文件 | 从正规渠道获取的授权信息,提前准备好,安装完成后再激活 |
另外要注意,TMS FNC系列内部还分不同产品线,UI Pack只是其中之一,如果你还装了FNC Chart、FNC Maps之类的包,版本号最好保持一致。混用不同版本在我实际测试中见过控件面板里出现重复项、IDE启动报错这类问题,虽然不是每次都发生,但没必要去赌。
2.2 安装、注册、验证的三步流程
安装向导本身没什么特殊,全程下一步就行。需要注意安装向导会让你选择“安装到哪些IDE版本和框架”,比如RAD Studio 12.3下的VCL和FMX都勾上。如果你同时装了多个Delphi版本,这里一定要看清楚,别只勾了老版本却发现新版本IDE里找不到控件。
安装完成后,打开Delphi 12.3,在Tool Palette搜索框里输入“FNC”,正常情况下应该能看到一长串以TTMSFNC开头的组件。如果搜索为空,优先检查Library路径里是否包含安装目录中的Source目录,没有就手动加一条。
还有一个容易忽略的点:安装包会往系统里注册BPL运行时包,如果在RAD Studio里打开旧工程时提示找不到某BPL,优先去Control Panel里确认组件是否注册成功,而不是急着重装。我在一个同事的机器上遇到过一次安装向导提示成功、但IDE里找不到控件的情况,最后排查下来是Windows用户账户权限隔离导致注册表写入到了另一个账户下,用管理员权限重新跑一遍安装程序就正常了。
2.3 用20分钟跑通一个跨框架Demo
装好之后,我建议你花20分钟做一个最小验证,确认跨框架能力真的符合预期。
第一步,新建一个FMX工程,在窗体上拖一个TTMSFNCCustomList,然后在FormCreate里写几行代码,添加几个菜单项:
procedure TForm1.FormCreate(Sender: TObject);
var
LItem: TTMSFNCListItem;
begin
TTMSFNCCustomList1.BeginUpdate;
try
LItem := TTMSFNCCustomList1.Items.Add;
LItem.Caption := '入库单查询';
LItem.DetailText := '按单号或供应商检索';
LItem := TTMSFNCCustomList1.Items.Add;
LItem.Caption := '出库单查询';
LItem.DetailText := '按单号或客户检索';
finally
TTMSFNCCustomList1.EndUpdate;
end;
end;
第二步,再新建一个VCL工程,同样拖TTMSFNCCustomList,把上面这段代码原样复制到FormCreate里,运行。
看到的效果会让你对“一套代码”这句话产生非常直观的感知:两个工程、两套UI框架,控件类的名字一样、属性一样、显示效果基本相同。这就是FNC最核心的价值。
3. 高频控件实测:Grid、List和主题系统
整个FNC UI Pack里的控件不少,但按我实际项目里的使用频率看,绝大多数人高频用到的其实就是三块:表格类、列表类、主题系统。
3.1 TTMSFNCGrid:比TStringGrid顺手在哪
TTMSFNCGrid是我在项目中用得最多的组件,它解决了一个长期痛点:VCL的TStringGrid或FMX的TGrid要做斑马纹、筛选行、列宽自适应,都得自己写一堆代码。FNCGrid里这些基本是选项级能力。
日常操作上,动态填充表格数据我用的是Columns和Rows的接口:
var
I, J: Integer;
begin
TTMSFNCGrid1.BeginUpdate;
try
TTMSFNCGrid1.Columns.Count := 4;
TTMSFNCGrid1.Columns[0].Caption := '单号';
TTMSFNCGrid1.Columns[1].Caption := '物料编码';
TTMSFNCGrid1.Columns[2].Caption := '数量';
TTMSFNCGrid1.Columns[3].Caption := '入库时间';
TTMSFNCGrid1.Rows.Count := 10;
for I := 0 to 9 do
begin
TTMSFNCGrid1.Cells[0, I] := 'RK-' + FormatDateTime('yyyymmdd', Now) + IntToStr(I);
TTMSFNCGrid1.Cells[1, I] := '100' + IntToStr(I * 7);
TTMSFNCGrid1.Cells[2, I] := IntToStr(10 + I);
TTMSFNCGrid1.Cells[3, I] := DateTimeToStr(Now);
end;
finally
TTMSFNCGrid1.EndUpdate;
end;
end;
几点体验说给你参考:
- 列宽自适应:设置Options.Columns.AutoSize为True之后,列宽会根据内容自动撑开,不需要我测量画布宽度。
- 斑马纹和单元格颜色:通过CellAppearance的相关属性配一下就行,不用在DrawCell事件里手动填色。
- 虚拟滚动:数据量超过几千行时,确认Options.Rows.Virtualization是开启的,否则滚动效率会明显下降,在低配PDA上尤其明显。
- 配合ADO读Excel或读取SQL查询结果时,我习惯先把数据加载到TClientDataSet,再循环写入FNCGrid的Cells,虽然不如专用数据源绑定自动,但胜在代码直观可控。
3.2 TTMSFNCCustomList:做移动端菜单最省事
在PDA这种小屏幕上,我基本不用Grid做主菜单,而是用TTMSFNCCustomList做纵向列表。它自带条目结构,每一个Item可以设置Caption主标题、DetailText副标题和Icon图标,正好够用。
这里有个容易踩的细节:Items.Add返回的对象如果要在设置属性之前使用,注意它默认是自动创建的,不需要手动Free。但是如果你在循环里大量添加Item,最好用BeginUpdate/EndUpdate包起来,不然每加一条都会触发一次重绘。
var
LItem: TTMSFNCListItem;
begin
TTMSFNCCustomList1.BeginUpdate;
try
LItem := TTMSFNCCustomList1.Items.Add;
LItem.Caption := '盘点任务';
LItem.DetailText := '今天还有3个任务未完成';
finally
TTMSFNCCustomList1.EndUpdate;
end;
end;
选中状态、点击事件这些都有现成事件,不需要用自定义对象去存状态。比较实用的还有“完全自定义绘制模式”,如果你觉得默认的条目标题+副标题样式不够用,可以挂OnDrawItem事件,自己绘制背景图和文字,做复杂的多媒体列表不在话下。
3.3 主题系统:深浅色秒切
TMS FNC UI Pack自带一套主题引擎,核心思路是给全局定一个色调,然后所有FNC控件都从这个全局对象里取颜色值,不用一个个控件去改。
我实际用的方式是:
TTMSFNCThemeManager1.Theme := tmsftLight;
// 或者 tmsftDark
切换主题后,运行期所有FNC控件会自动刷新颜色。我在仓储系统里做了个用户设置功能,让用户在“明亮”和“暗色”之间切换,其实就是改一个枚举值,对用户来说体验很好,对开发来说成本极低。
如果你的品牌色和默认主题差异很大,可以修改ThemeManager的配色列表里的颜色值,比如PrimaryColor、BackgroundColor、TextColor这些字段。这样全局统一品牌色,不用在几十个窗体里分别设置。
4. 真机调试中记录的三类典型坑
这部分是整篇文章里我最想写的内容。FNC在开发机上跑得顺,不等于在真机或客户机器上就万事大吉。下面几个问题我都是在实际项目中真真切切踩过的,排查过程值得记录一下。
4.1 子控件间距和布局漂移问题
现象:在FMX工程里把TTMSFNCCustomList的高度从48改到56之后,列表Item内部的标题文字和副标题文字上下间距变得不对称,视觉上明显偏上;在部分Windows高DPI环境下,VCL里用FNC表格时,列头文字和边框也有1到2个像素的错位。
排查过程:我先以为是ItemHeight设置被覆盖,检查后发现属性确实生效了。后来怀疑是FMX的Layout换算精度问题,把Form的ScaleMode和TextScale改了几轮,问题依旧。最后在TMS文档的Known Issues里翻到一句话:FNC自绘组件在非整数缩放比例下可能出现亚像素偏差。
解决方式分两步。第一步,FNC控件所在的窗体,如果是在Windows上运行,尽量把系统DPI缩放比例设置为100%、125%、150%这类整数比例,200%这种没问题但最好也测试一轮。第二步,针对Item内部布局,关闭AutoItemHeight,手动指定Item高度之后,再在ItemAppearance属性里调整TextLayout和DetailLayout的Margin值,用微调来补偿像素偏差。
这类问题不致命,但会在截图评审阶段被当成细节质量问题提出来,所以我处理得很仔细。
4.2 Android PDA扫码的焦点和输入分割问题
这个坑排在我个人吐槽榜第一名。仓库PDA的扫码枪本质是个HID键盘模拟设备,扫到条码后会按字符快速模拟按键输入。正常情况下你把它当成外接键盘就行,但在FNC组件场景下会出两种状况:
第一种是扫码输入过程中,焦点被某个控件的Click事件或者列表刷新打断,导致一串条码被拆成两半。第二种是扫码输入穿过软键盘弹出逻辑,PDA屏幕本来就不大,软键盘一弹,FNC列表的可用高度骤减,界面跳来跳去。
我的处理方案是给条码输入Edit做一个“键盘缓冲+时间窗口”的机制:在OnKeyDown里做字符累积,超过100毫秒没有新按键就认为一次扫码输入结束,然后一次性触发查询。伪代码如下:
procedure TForm1.edtBarcodeKeyDown(Sender: TObject; var Key: Word; var KeyChar: Char;
Shift: TShiftState);
begin
if KeyChar <> #0 then
begin
FTempBarcode := FTempBarcode + KeyChar;
Key := 0; // 阻止默认输入,等扫描完整后再统一填入
if Assigned(FTimer) then
FTimer.Enabled := False;
FTimer.Interval := 100;
FTimer.Enabled := True;
end;
end;
procedure TForm1.FTimerTimer(Sender: TObject);
begin
FTimer.Enabled := False;
edtBarcode.Text := FTempBarcode;
FTempBarcode := '';
QueryBarcode(edtBarcode.Text);
end;
这个方案在10台不同品牌的PDA上实测下来都稳定,因为它本质上不依赖扫码枪是哪个厂商,只依赖键盘输入这个通用协议。还有一点,查询结束之后我习惯手动调用一个允许系统休眠软键盘的接口,避免每次扫码都弹一次软键盘。
4.3 性能、内存和低端设备
FNC组件因为是自绘渲染,所有可见元素都是GDI或GPU绘制出来的,在高端开发机上跑没什么感觉,但在仓库那种几百块钱安卓PDA上,数据量一大就原形毕露。
我实测过一台四核1.8GHz、内存3GB的PDA,TTMSFNCGrid加载4000行数据、每行6列,默认配置下滚动有明显掉帧。后来做了三步优化,效果立竿见影:
- 开启虚拟滚动,让Grid只在可见区域创建绘制任务;
- 把不需要的动画效果全部关掉,比如选中态动画、滚动回弹动画;
- 在Android上关闭窗体的全局阴影和透明效果,减少GPU渲染层的合成负担。
优化之后滚动流畅度达到可接受水平。我的经验是,用FNC组件前先想清楚目标设备的硬件底线,不要在UI动画上过度追求华丽,稳定才是第一位的。
4.4 和后端数据处理的几个配合点
最后补充几个和FNC控件没直接关系但配合使用时很常见的点,因为都是我在同个项目里遇到的,一并写出来。
- JSON解析:Delphi 12.3自带的System.JSON足够用。我拿TJSONObject解析接口返回数据,然后循环填充到TTMSFNCGrid,过程简单直接。
- MD5计算:Delphi 10.4之后用System.Hash.THashMD5,比如GetHashStringFromStream。
- 执行DOS命令获取返回值:Windows下用CreateProcess或者直接调用系统命令,但一定要放到TThread里跑,不能阻塞UI线程,完成后用TThread.Queue回到主线程刷新FNC列表。
- ADO连Excel:老项目里常见的Excel数据源场景,用ADO连Excel文件后查出来的结果集,同样可以复用上面的循环填充网格逻辑。
这些配合点虽然不起眼,但项目里一旦用上,就能避免在UI主线程里做耗时操作,直接影响FNC控件的流畅表现。
5. 值不值得上FNC:我的最终判断
用完整套流程之后,我的判断是:要看你项目的边界条件。
如果你的项目需要同时维护VCL和FMX两套界面,或者明确后面要上Android/iOS移动端,那FNC很值得投入。它能让你把UI层的代码收敛成一套,字段增删改不用在两个工程里同步,视觉一致性也天然好。TMS官方对FNC的支持力度也比较强,文档和示例工程都齐全,遇到问题不至于抓瞎。
如果项目是纯Windows桌面、重度依赖VCL生态里那些原生控件,比如业务系统里用了大量OleContainer、ActiveX、第三方VCL网格组件,那我不建议为了FNC做全面替换。FNC的自绘机制在系统级交互场景里还是替代不了原生窗口控件,强行迁移只会引入一堆兼容问题。
从版本稳定性来说,v6.2.0.0配合Delphi 12.3在我这边的日常使用中没遇到崩溃级别的Bug,偶尔有小毛病也都能通过属性配置绕过去。最后说一个升级经验:TMS FNC这类控件包升级前,一定要用RAD Studio的Package管理器看一下当前工程依赖了哪个版本的BPL,千万别在旧工程上直接装新包,否则打开工程时会遇到控件类不存在或属性缺失的报错,那时候再回滚就麻烦了。
331



被折叠的 条评论
为什么被折叠?



