OfficeXml/迁移指南.md

迁移指南

v2.0.0

该版本对基类做了调整

1. OpenXmlElement -> OpenXmlElement，类名不变，功能变更为基类

2. OpenXmlPcdata -> OpenXmlTextElement，类名变更，继承基类，使用方式不变

3. OpenXmlEmpty -> OpenXmlSimpleType，类名变更，继承基类，设计与使用方法需要调整

   // 弃用
   rpr := new RPr();
   rpr.B := true; // 启用B，B是Empty元素，对应xml <b/>
   rpr.B.Val := 1; // <b w:val="1" />
   // 读
   echo rpr.B; // 判断是否启用了B
   
   // 迁移
   rpr := new RPr();
   rpr.B.Enable := true; // 启用B，不设置属性时候，对应xml <b />
   rpr.B.Val := "0"; // 会自动设置Enable为1，对应xml <b w:val="0" />
   // 只读
   echo rpr.B.IsApplied; // 只读属性，判断是否启用了B
   

4. 新增OpenXmlCompositeElement复杂类型的节点类，提供各种操作的方法，大部分有子节点的类均继承于该类。如RPr会有B I Sz等子节点元素，而B I这类的元素是<x />的OpenXmlSimpleType类型的

影响范围：列表暂无；具体可见对应类的// simple_type property下的属性

v3.0.0

对adapter做了break changes的更新

1. unit文件更名为adapters复数结尾，如DocxMLAdapter -> DocxMLAdapters
2. 移除冗余的命名方式（移除每个类的Adapter后缀），StylesAdapter -> Styles

// 弃用
uses DocxMLAdapter;

styles_adapter := new DocxMLAdapter.StylesAdapter(styles);

// 迁移
uses DocxMLAdapters; // 复数s
styles_adapter := new DocxMLAdapters.Styles(styles); // 移除冗余