UI设计器 · 函数

保存界面到项目

把设计稿保存到项目独立 ui 目录，并更新 ui索引.json。

调用签名(项目目录, 设计稿: 'dict', 界面名: 'str | None' = None, ui目录名: 'str' = 'ui') -> 'Path'

保ZHONGWEN
PYTHON

Chinese example

中文代码示例

# 案例：查看 UI 设计器入口
设 功能 = UI设计器.保存界面到项目
打印(功能)

可直接放进 .cs / .中py 文件运行。转换器会把中文代码交给真实 Python 解释器。

Parameters

参数说明

4 个参数

参数类型 / 传入方式说明

项目目录可选 · 默认无

未声明位置参数或字段名=值

常见错误：漏传或路径不存在会报 FileNotFoundError;先确认路径拼写并用存在检查

设计稿可选 · 默认无

dict位置参数或字段名=值

由创建设计稿或新建设计稿返回的设计稿字典对象。

常见错误：漏传或对象为 None 会报 TypeError/AttributeError;先调用对应的创建函数拿到设计稿再传入

界面名可选 · 默认 None

str | None位置参数或字段名=值

按函数业务含义传入界面名;首次使用建议先打印(结果) 确认其作用。

常见错误：类型不匹配会报 TypeError;按字段类型(str | None) 传值

ui目录名可选 · 默认 'ui'

str位置参数或字段名=值

常见错误：路径不存在会报 FileNotFoundError;先用存在检查或确认路径拼写

Playbook

基础用法 · 进阶组合 · 错误排查

# 案例：查看 UI 设计器入口
设 功能 = UI设计器.保存界面到项目
打印(功能)

# 进阶组合:保存界面到项目 配合 UI设计器 业务流使用
设 设计稿 = UI设计器.新建设计稿("业务界面", 宽=800, 高=600)
设 结果 = UI设计器.保存界面到项目(
    项目目录="outputs/示例.txt",  # 必填
    设计稿=设计稿,  # 必填
    界面名=None,  # 可选
)
设 代码 = UI设计器.导出代码(设计稿, 平台="Tkinter")
打印(结果)

# 错误排查:覆盖 2 个必填参数

## 参数 1: 项目目录
# 错误:路径不存在会报 FileNotFoundError
# 设 结果 = UI设计器.保存界面到项目(项目目录="不存在的文件")  # FileNotFoundError
# 修复:先确认路径存在
设 路径 = "outputs/示例"
设 结果 = UI设计器.保存界面到项目(项目目录=路径)

## 参数 2: 设计稿
# 错误:漏传或为 None 会报 TypeError/AttributeError
# 设 结果 = UI设计器.保存界面到项目(设计稿=None)  # AttributeError
# 修复:先建立 设计稿 再传入
设 设计稿 = UI设计器.新建设计稿("业务界面")
设 结果 = UI设计器.保存界面到项目(设计稿=设计稿)
打印(结果)