how to develop widget | CFDesktop 文档

Skip to content

CFDesktop 文档

Main Navigation 首页状态开发架构桌面路线图手册 GitHub

Appearance

Sidebar Navigation

开发手册

基础工具库

expected - 错误处理

factory - 工厂模式

hash (FNV-1a) - 编译期哈希

Linux 工具

procparser - Linux 文件解析工具

宏定义系统

plainproperty - 简单属性宏

systemjudge - 系统判断宏

macros - 宏定义系统

MpscQueue - 无锁多生产者单消费者队列

CallOnceInit - 懒加载初始化

基础工具库

PolicyChain - 策略链

scopeguard - 作用域守卫

Singleton - 单例模式

span - 容器视图

weakptrfactory - 弱引用工厂

weakptr - 非拥有弱引用指针

桌面环境手册

基础组件

ConfigStore 手册

快速入门

ConfigStore 最佳实践

ConfigStore 常见问题与故障排查

ConfigStore 架构详解

CFLogger 手册

高级用法

基础日志详解

最佳实践

配置选项

格式化器 (Formatter) 详解

CFLogger 使用手册

性能优化

快速入门

Sink 详解

故障排除

示例代码

CPU 信息查询示例

平台实现

Linux 平台实现

Linux 平台实现细节

Linux 内存检测

Linux 平台实现细节

Windows 平台实现

Windows 平台实现细节

Windows 内存检测

Windows 平台内存模块实现

UI 框架

应用框架

Application - 应用基础类

MaterialApplication - Material 应用

架构总览

Layer 1: 数学与工具层

从零开始——为什么我们决定自己造轮子

HCT 色彩空间实战——Material 动态主题的数学基础

几何与设备无关——跨 DPI 适配的完整方案

Layer 2: 主题引擎

主题系统架构设计——从单例到工厂的完整方案

Token 系统设计——字符串字面量的编译时魔法

颜色方案实现——从种子颜色到完整主题

字体、形状与动效——完整的设计规范系统

Layer 3: 动画引擎

动画引擎架构——统一调度的生命线管理

时间与弹簧——两种动画范式的完整实现

工厂与策略——动画创建的灵活组合模式

Layer 4: Material 行为

状态机设计——Material 交互状态的核心管理器

涟漪与阴影——Material 视觉反馈的完整实现

焦点指示器——无障碍访问的视觉实现

Layer 5: 组件适配层

适配器模式——Material 控件的\"薄包装\"设计

Button 控件深度解析——七步绘制流程的完整实现

绘制管道优化——从单一控件到批量渲染的性能考量

UI 基础工具

colorhelper - 颜色助手

color - HCT 色彩空间

devicepixel - 设备像素 (DPI 缩放)

easing - 缓动曲线

geometryhelper - 几何助手

mathhelper - 数学工具

UI 组件

ICFAnimationManagerFactory - 动画工厂管理器

ICFAnimationGroup - 动画组

ICFAbstractAnimation - 动画基类

ICFSpringAnimation - 弹簧动画

ICFTimingAnimation - 时间动画

UI 核心引擎

ICFColorScheme - 颜色方案接口

IFontType - 字体样式接口

IMotionSpec - 动画规格接口

IRadiusScale - 圆角规范接口

ThemeFactory - 主题工厂

ThemeManager - 主题管理器

ICFTheme - 主题接口

Design Token

Material 配色方案

Material Token 字面量

动效系统

Motion Token 字面量

圆角系统

Radius Scale Token 字面量

排版系统

Typography Token 字面量

how to develop widget

Material Design

Material 动画

CFMaterialAnimationFactory - Material 动画工厂

AnimationStrategy - Material 动画策略

CFMaterialFadeAnimation - Material 淡入淡出动画

CFMaterialScaleAnimation - Material 缩放动画

CFMaterialSlideAnimation - Material 滑动动画

Material 基础

MdElevationController - Material 阴影控制器

MdFocusIndicator - Material 焦点环

PainterLayer - 绘图层管理器

RippleHelper - Material 涟漪效果助手

MaterialTypography - Material 字体系统

MaterialMotionScheme - Material 动画系统

MaterialRadiusScale - Material 圆角系统

MaterialColorScheme - Material Design 3 颜色方案

MaterialTheme - Material Design 3 主题

MaterialFactory - Material 主题工厂

materialfactory.hpp - Material 工厂函数

Material 组件

Button - Material 按钮

CheckBox - Material 复选框

ComboBox - Material 下拉框

DoubleSpinBox - Material 双精度数值调节框

GroupBox - Material 分组框

Label - Material 标签

ListView - Material 列表视图

ProgressBar - Material 进度条

RadioButton - Material 单选按钮

ScrollView - Material 滚动视图

Separator - Material 分隔线

Slider - Material 滑块

SpinBox - Material 数值调节框

StateMachine - Material 状态机

Switch - Material 开关

TableView - Material 表格视图

TabView - Material 标签页

TextArea - Material 多行文本框

TextField - Material 文本输入框

TreeView - Material 树视图

On this page

在 GitHub 上编辑此页

Last updated:

Pager

Previous pageTypography Token 字面量

Next pageMaterial Design

Built with VitePress