EtsT_Obj_Dbox_Confirm_Handler
摘要
回调:用于将用户提出的修改更新到属性对象。
语法
<object_dbox_confirm_handler_name> (attr_name, orig_object, copy_object)
| 参数 | 类型 | 说明 |
|---|---|---|
attr_name |
const char * |
属性对象的名称。 |
orig_object |
EtsT_Obj_Handle |
原始属性对象的句柄。 |
copy_object |
EtsT_Obj_Handle |
包含所提议修改的原始属性对象副本的句柄。 |
返回类型
EtsT_Obj_Dbox_Confirm_Options
下列常量之一:
EtsC_Obj_Dbox_Confirm_None—表示该处理器已验证 copy_object 的属性值,且这些值已复制到 orig_object
EtsC_Obj_Dbox_Confirm_Value_Invalid—表示 copy_object 中包含的一组属性值无效,orig_object 中的属性值未被更改
头文件
ets_api_obj_dbox.h
详情
当用户修改属性并在属性对话框中点击 OK 后,应用程序会调用对象对话框确认处理器。通常,只有当用户直接修改属性时才会调用对象对话框确认处理器;如果用户通过 “Apply changes to selected objects” 选项修改对象的属性,则不会调用对象对话框确认处理器。此行为可以通过 “edit_attr_confirm_handler_for_all“ 首选项更改。
你可以使用该处理器验证一组多项属性修改;如果修改无效,返回 EtsC_Obj_Dbox_Confirm_Value_Invalid。
此类回调在属性的 Enter ETS Handlers 对话框中注册为 Confirm Handler(参见“Active Attributes“(第 51 页))。