EtsT_Xml_Import_Postproc_Func
摘要
回调:在从 XML 文件创建网络模型之后,对模型中的每个对象调用。
语法
EtsT_Xml_Import_Postproc_Func (xml_data_ptr, attr_lptr, pstate_lptr, client_data_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
xml_data_ptr |
EtsT_Xml_Postproc_Datum * |
关于当前对象的信息(参见详情) |
attr_lptr |
PrgT_List * |
属性列表。包含在解析当前对象过程中找到的 EtsT_Xml_Attribute 类型元素。 |
pstate_lptr |
PrgT_List * |
与给定 postproc datum 关联的 pstate 元素列表。 |
client_data_ptr |
void * |
传递给每次 postproc_func 调用的用户自定义状态。 |
返回类型
void
无返回值。
头文件
ets_api_xml.h
详情
xml_data_ptr 指向一个数据结构,其中包含在骨架模型中创建的受影响 ETS 对象的句柄、XML 属性类型、对象名以及 XML 属性处理模式。该结构的定义为:
typedef struct EtsT_Xml_Postproc_Datum
{
EtsT_Obj_Handle ets_obj_hndl;
EtsT_Xml_Attribute_Type type;
const char* object_name;
EtsT_Xml_Attr_Proc_Mode attr_proc_mode;
} EtsT_Xml_Postproc_Datum;
该结构中使用的类型定义如下:
typedef enum EtsT_Xml_Attribute_Type
{
EtsC_Xml_Attribute_Type_Child,
EtsC_Xml_Attribute_Type_Object
} EtsT_Xml_Attribute_Type;
typedef enum EtsT_Xml_Attr_Proc_Mode
{
EtsC_Xml_Attr_Proc_Mode_Loose,
EtsC_Xml_Attr_Proc_Mode_Explicit
} EtsT_Xml_Attr_Proc_Mode;
XML 属性处理模式有两种选项:
- Loose 模式不要求属性的 XML 规范是完整的。未指定的属性值采用节点模型初始值赋值中的值。使用此模式可以从自定义的 XML 规范构建网络模型。
- Explicit 模式意味着属性的 XML 规范是完整且详尽的。若未显式指定,属性值将采用底层进程模型中的默认值。使用此模式可在
Ets_Xml_Export()与Ets_Xml_Import()的调用之间完整保留网络模型。
该回调由 Ets_Xml_Import() 注册。