Lazarus 自绘控件库。162 个控件全部由 BGRABitmap 绘制,外观由 .tycss 文本主题统一控制,在 Windows、Linux、macOS 上显示效果完全一致。
English: README.en.md · 更新日志: CHANGELOG.md
同一个程序,只换一个主题名:
classic |
win11 |
material3 |
|---|---|---|
 |
 |
 |
四张图是同一份 .lfm、同一份代码,只改了主题名。主题不只换配色:classic 下按钮是立体边框、方角、渐变标题带。
| 亮色 | 暗色 | green(图片主题) |
|---|---|---|
 |
 |
 |
亮暗是同一个主题文件里的两套 @mode 取值,可跟随操作系统。green 是照片背景加半透明控件的图片主题。
TTyStringGrid 冻结列、行号槽、汇总带 |
TTyTreeView 虚拟树、多列、三态复选 |
富输入控件 数值 / 货币 / 掩码 / 滑块 / 计算器 |
自绘对话框 取色器 |
- 162 个控件:按钮、输入、列表、数据网格、虚拟树、Ribbon、日历、Shell 文件浏览、20 个自绘对话框,一套配齐
- 三平台一致:完全自绘,不包装原生控件,同一份代码在三个平台上渲染出同样的界面
- 主题换肤:17 个内置主题一个属性切换,支持运行时热切换、跟随系统明暗和强调色;主题是文本文件,改外观不用重编译
- 经典与现代两种风格:从 Win95 / XP 的立体风到 Win11 / Material 的扁平风都能做,控件密度也可整体切换
- HiDPI:矢量绘制,任意缩放比例下清晰;跨屏拖动自动适配新 DPI
- 设计器支持完整:组件面板拖放、容器控件直接拖入、主题效果设计期可见、File → New 工程模板
- 内置 2022 个矢量图标(Lucide),按名字取用,不用则不占体积
- 中英文界面,gettext
.po翻译 - 6000+ 单元测试,全套无内存泄漏
| 平台 | Widgetset |
|---|---|
| Windows | Win32 / Win64 |
| Linux | GTK2、Qt5、Qt6;GTK3 部分支持(Wayland 下有已知问题) |
| macOS | Cocoa |
依赖:Lazarus 3.x+、FPC 3.2.2+、BGRABitmap(OPM 包名 BGRABitmapPack)。
1. 安装包
Lazarus 里打开 tycontrols_dt.lpk,点 Use → Install,IDE 重新编译并重启。运行期包 tycontrols.lpk 作为依赖自动安装。
2. 新建工程
File → New… → Project → TyControls 应用程序
模板生成的主窗体已带自绘标题栏、内容容器 Surface 和样式控制器。控件放在 Surface 里(TTyForm 的可视控件都放它上面,图形控件必须放进去,详见 TTyForm 文档)。给已有工程加窗体用 File → New… → Form → TyControls 窗体。
3. 换主题
选中窗体上的 TTyStyleController,把 ThemeName 改成任意内置主题名。设计器里立即生效,运行时改同一个属性即热切换。
完整步骤见 docs/getting-started.md。
162 个控件,分 16 个组件面板分页。每个控件的属性、事件、主题键说明见 docs/controls/。
| 控件 | 说明 |
|---|---|
TTyStyleController |
样式控制器:加载主题、切换密度、跟随系统亮暗 |
TTyNativeStyler |
让原生 / 第三方 LCL 控件跟随当前主题着色 |
| 控件 | 说明 |
|---|---|
TTyButton |
按钮,支持 primary / danger / ghost 变体和数字徽标 |
TTyGlyphButton |
带图标的按钮 |
TTyGlyphContainerButton |
只放图标的方形按钮,常用于工具条 |
TTySpeedButton |
可保持按下态的快捷按钮 |
TTyDropDownButton |
分裂按钮:左半执行、右半展开菜单 |
TTyMenuButton |
整个按钮都是下拉触发器 |
TTyColorButton |
显示并选择颜色的按钮 |
TTyButtonGroup |
分段按钮条,相邻段共边、单选 |
| 控件 | 说明 |
|---|---|
TTyLabel |
文本标签,支持自动换行(含中日韩逐字断行)和助记符 |
TTyHtmlLabel |
支持行内 HTML 子集(粗体 / 斜体 / 链接 / 颜色)的标签 |
TTyLinkLabel |
超链接文字 |
TTyShadowLabel |
带投影的标签 |
TTyGlowLabel |
带发光描边的标签 |
TTyTag |
可关闭的标签胶囊 |
TTyBadge |
数字 / 圆点角标,可吸附到任意控件 |
| 控件 | 说明 |
|---|---|
TTyEdit |
单行文本框:选区、剪贴板、词级导航 |
TTyMemo |
多行文本框 |
TTySpinEdit |
整数微调框 |
TTyFloatSpinEdit |
小数微调框,步长可小于 1 |
TTyNumericEdit |
只接受数字的输入框,失焦时千分位格式化 |
TTyCurrencyEdit |
货币输入框 |
TTyMaskEdit |
掩码输入框(电话、身份证、日期等) |
TTyURLEdit |
网址输入框,尾部带打开按钮 |
TTyComboEdit |
文本框 + 下拉箭头,下拉内容自定义 |
TTyTrackEdit |
内嵌滑块的数值输入框 |
TTyCalcEdit |
内嵌计算器的输入框 |
TTyCalcCurrencyEdit |
货币版计算器输入框 |
TTyCalculator |
独立计算器面板 |
TTyUpDown |
独立的上下微调按钮,可绑定其他控件 |
| 控件 | 说明 |
|---|---|
TTyCheckBox |
复选框,支持三态 |
TTyRadioButton |
单选按钮 |
TTyToggleSwitch |
开关 |
TTyRadioGroup |
带标题框的单选组 |
TTyCheckGroup |
带标题框的复选组 |
TTySegmented |
分段控制器 |
| 控件 | 说明 |
|---|---|
TTyComboBox |
下拉框,可编辑,支持前缀补全 |
TTyListBox |
列表框 |
TTyCheckListBox |
每行带复选框的列表 |
TTyMRUComboBox |
记住最近输入的下拉框 |
TTyComboBoxEx |
每项可带图标的下拉框 |
TTyOfficeComboBox |
带分组标题的下拉框 |
TTyOfficeListBox |
带分组标题的列表 |
TTyAdvancedComboBox |
每项两行(标题 + 副标题 + 图标)的下拉框 |
TTyAdvancedListBox |
每项两行的富列表 |
TTyCheckComboBox |
可多选的下拉框 |
TTyValueListEditor |
属性表:左键右值,每行可指定编辑器 |
TTyTransfer |
双列表穿梭框 |
TTyTreeSelect |
树形下拉选择器 |
TTyCascader |
级联选择器(省 / 市 / 区) |
| 控件 | 说明 |
|---|---|
TTyColorBox |
颜色下拉框 |
TTyColorComboBox |
颜色下拉框,末尾带「更多…」打开取色对话框 |
TTyColorListBox |
颜色列表 |
TTyColorGrid |
方格调色板 |
TTyLColorPicker |
亮度条取色器 |
TTyHSColorPicker |
色相 / 饱和度取色器 |
TTyFontComboBox |
字体下拉框,逐项用自身字体预览 |
TTyFontListBox |
字体列表 |
TTyFontSizeComboBox |
字号下拉框 |
TTyFilterComboBox |
文件类型过滤下拉框 |
TTyShellComboBox |
目录下拉框 |
| 控件 | 说明 |
|---|---|
TTyGauge |
仪表:线性 / 弧形 / 环形 |
TTyMeter |
指针式仪表盘 |
TTyLevelMeter |
电平表,分段点亮 + 峰值保持 |
TTyDial |
旋钮 |
TTyGearDial |
齿轮外圈旋钮 |
TTyAnalogClock |
模拟时钟 |
TTyCircularProgress |
环形进度 |
TTyActivityIndicator |
旋转忙碌指示环 |
TTyActivityBar |
不确定进度条 |
TTyGearActivityIndicator |
齿轮忙碌指示 |
TTySparkline |
迷你趋势图 |
TTyRating |
星级评分 |
| 控件 | 说明 |
|---|---|
TTyTrackBar |
滑块 |
TTyProgressBar |
进度条 |
TTyScrollBar |
滚动条 |
TTyStatusBar |
状态栏 |
TTyToolBar |
工具条 |
TTyToolButton |
工具条按钮:命令 / 开关 / 下拉 / 分组 / 分隔等六种样式 |
TTyToolSeparator |
工具条分隔符 |
TTyToolBarEx |
放不下的按钮自动折进溢出菜单的工具条 |
TTyControlBar |
按宽度自动折行分带的容器 |
TTyCoolBar |
可拖动的带条容器 |
TTyAlert |
内联警告条:信息 / 成功 / 警告 / 错误 |
TTyPagination |
分页器 |
TTySteps |
步骤条 |
TTyBreadcrumb |
面包屑导航 |
TTyHeaderControl |
独立列头条 |
| 控件 | 说明 |
|---|---|
TTyPanel |
面板 |
TTyGroupBox |
分组框 |
TTyCard |
卡片:标题 / 内容 / 操作 |
TTyExPanel |
可折叠面板 |
TTyScrollBox |
滚动容器 |
TTyScrollPanel |
拖到边缘自动滚动的容器 |
TTyGridPanel |
设计器网格容器,格子可直接拖入控件 |
TTyRelativePanel |
按相对关系布局的容器 |
TTyPageControl |
多页容器,页面可直接拖入控件 |
TTyTabSheet |
TTyPageControl 的页 |
TTyTabSet |
纯页签条,不承载页面 |
TTySplitter |
分隔条 |
TTyBevel |
凹凸装饰线 |
TTyDivider |
分隔线,可带标题 |
TTyPaintPanel |
自绘面板 |
TTySizeBox |
右下角尺寸手柄 |
TTyToolGroupPanel |
工具分组容器 |
TTyListGroupPanel |
带分组标题的列表容器 |
TTyTitleBar |
自绘标题栏,配合 TTyForm |
TTyEmpty |
空状态:插画 + 文案 + 操作按钮 |
| 控件 | 说明 |
|---|---|
TTyStringGrid |
数据网格:冻结、虚拟化、编辑、筛选、分组、撤销重做 |
TTyDrawGrid |
内容自绘的网格 |
TTyTreeView |
虚拟树,可承载百万节点;多列、三态复选、内联编辑、拖放 |
TTyListView |
列表视图:报表 / 图标 / 平铺等五种视图 + 分组 + 虚拟模式 |
TTyShellTreeView |
文件系统目录树 |
TTyShellListView |
文件系统文件列表 |
TTyCalendar |
日历:日 / 月 / 年下钻 |
TTyDateTimePicker |
日期时间选择器,支持空值 |
TTyImageView |
图片查看器:平移、缩放、滤镜 |
TTyPreviewBox |
文件预览框 |
| 控件 | 说明 |
|---|---|
TTyMenuBar |
主菜单栏 |
TTyPopupMenu |
右键菜单 |
TTyImagesMenu |
带图标的菜单 |
TTyMenuEx |
扩展菜单 |
| 控件 | 说明 |
|---|---|
TTyRibbon |
Ribbon 主体 |
TTyRibbonPage |
Ribbon 页 |
TTyRibbonGroup |
页内功能组 |
TTyRibbonAppMenu |
应用菜单(File)按钮 |
TTyRibbonQuickAccess |
快速访问工具栏 |
TTyRibbonGallery |
图库,可展开成弹出网格 |
TTyRibbonBackstage |
全窗口后台视图 |
| 控件 | 说明 |
|---|---|
TTyIconFont |
图标字体:按码点或名字取矢量图标,随主题着色 |
TTyCharImage |
把一个图标字形当图片用 |
TTyImage |
图片控件 |
TTyGlyphImageList |
图标字体驱动的图像列表 |
TTyImageCollection |
多分辨率图像集,按 DPI 取图 |
TTyVirtualImageList |
按需生成任意尺寸的图像列表;本身是标准 TCustomImageList,可赋给任何控件,支持按名字取图 |
TTyHint |
主题化提示气泡 |
TTyBalloonHint |
带箭头的气球提示 |
TTyPopover |
可承载控件的气泡浮层 |
内置图标(Lucide):加一行 uses tyControls.Icons.Lucide 就有 2022 个矢量图标,按名字取用:
CharImage1.IconFont := TyLucideFont;
CharImage1.GlyphName := 'house';字体内嵌在单元里,不用随程序分发文件;不 uses 就不进最终程序。组件面板上的 TTyLucideImageList 可以直接当图像列表拖放使用。许可为 ISC / MIT,商用无需署名,随发布带上 THIRD-PARTY-NOTICES.md 即可。
| 控件 | 说明 |
|---|---|
TTyShape |
矢量形状:矩形 / 圆 / 三角 / 菱形 / 星形等 15 种,支持自定义多边形 |
TTyStarShape |
星形,角数可调 |
TTyArrow |
方向箭头 |
TTyChart |
图表:折线 / 柱状 / 饼图 |
| 控件 | 说明 |
|---|---|
TTyMessage |
消息框 |
TTyInputDialog |
文本输入对话框 |
TTyPasswordDialog |
密码输入对话框 |
TTyTextDialog |
多行文本对话框 |
TTySelectValueDialog |
列表单选对话框 |
TTySelectPathDialog |
文件夹选择对话框 |
TTyColorDialog |
取色对话框:HSV / RGB / CMYK / Alpha |
TTyFontDialog |
字体对话框,带实时预览 |
TTyFindDialog |
查找对话框 |
TTyReplaceDialog |
查找替换对话框 |
TTyProgressDialog |
进度对话框 |
TTyAboutDialog |
关于对话框 |
TTyOpenDialog |
打开文件对话框 |
TTySaveDialog |
保存文件对话框 |
TTyOpenPictureDialog |
打开图片对话框,带缩略图 |
TTySavePictureDialog |
保存图片对话框 |
TTyOpenPreviewDialog |
打开对话框 + 自定义预览 |
TTySavePreviewDialog |
保存对话框 + 自定义预览 |
TTyNotification |
角落通知,自动消失 |
TTyIconBrowserDialog |
图标浏览器 |
TTyStringGrid、TTyTreeView、TTyForm 的完整能力见各自文档:grid.md · treeview.md · ttyform.md。
内置主题编译进二进制,程序不用带 themes/ 文件夹就能按名切换:
| 主题 | 说明 |
|---|---|
default |
中性基底,亮暗同文件 |
system |
跟随操作系统亮暗和强调色 |
win11 win10 xp classic aero |
Windows 各代风格 |
macos adwaita breeze ubuntu |
macOS 与 Linux 桌面风格 |
material3 fluent antdesign bootstrap |
常见设计体系 |
office |
Office 风格 |
showcase |
展示主题 |
另有图片主题 green(以文件提供)和 themes/palettes/ 调色板。所有主题共用同一套语义变量,--accent 可在运行时覆盖成任意品牌色。
写自己的主题见 docs/themes.md,.tycss 语言参考见 docs/tycss-reference.md。
每个示例都可独立构建:lazbuild examples/<名称>/<工程>.lpi。
| 示例 | 内容 |
|---|---|
| antdesign | 仿 Ant Design Pro 后台(侧边导航 + 6 页),运行时换肤 |
| demo | 综合演示:全部控件 + 多主题 + 切换语言 |
| grid | 数据网格:冻结 / 百万行 / 排序筛选分组 / 16 种编辑器 / 撤销重做 |
| treeview | 虚拟树:百万节点 / 多列 / 复选 / 内联编辑 / 拖放 |
| dialogs | 全部自绘对话框 |
| theming | 自定义主题 + 运行时热切换 |
| ribbon | Ribbon 全家桶 |
| containers | 布局容器 |
| listview | 列表视图:五视图 / 分组 / 10 万行虚拟 |
| inputs | 富输入控件 |
| shapes | 形状控件 + StyleOverride |
| rtl | 从右往左镜像与双向文本 |
| icons | 图标字体 |
| transitions | 滑入 / 淡入过渡 |
其余 30 多个单控件示例见 examples/。
| 文档 | 内容 |
|---|---|
| getting-started.md | 安装、第一个窗体、主题、HiDPI |
| controls/ | 逐控件 API 说明 |
| themes.md | 写自己的主题 |
| tycss-reference.md | .tycss 语言参考 |
| events.md | 通用事件约定 |
| rtl.md | 双向文本与右到左布局 |
| known-issues.md | 已知问题 |
| CHANGELOG.md | 更新日志 |
库自带中英文界面。LCL 的 SetDefaultLang 只加载应用自己的 .po,库的翻译要多加一行:
uses ..., LCLTranslator;
SetDefaultLang('', LangDir); // 应用
TranslateUnitResourceStringsEx('', LangDir, 'tycontrols', 'tyControls.StrConsts'); // 控件库部署时把 languages/tycontrols.<语言>.po 与应用自己的 .po 放在同一个 languages/ 目录。注意两点:
- 部署文件名是
tycontrols.<语言>.po,由源码里的tycontrols.strconsts.<语言>.po改名而来。第三个参数必须传'tycontrols'(不能带点,LCL 会把点号后面当扩展名剥掉),第四个参数传真实单元名tyControls.StrConsts。 - 英文部署也要带
tycontrols.en.po,它是日历和日期框的月份、星期名跟随应用语言的开关。
完整示例见 examples/demo。
修改版 LGPL,与 FPC RTL / LCL / BGRABitmap 相同:可以静态链接进闭源商业软件分发;修改库本身的源码时,修改部分需以同样许可开放。
完整条款见 COPYING.modifiedLGPL.txt 与 COPYING.LGPL.txt。