EtsT_Obj_Dbox_New_Value_Handler
摘要
回调:用于将用户输入转换为属性值,并将这些值复制到对象的一份副本。
语法
<object_dbox_new_value_handler_name> (attr_name, value_str, orig_object, copy_object)
| 参数 | 类型 | 说明 |
|---|---|---|
attr_name |
const char * |
对象名称。 |
value_str |
const char * |
新值。 |
orig_object |
EtsT_Obj_Handle |
原始属性对象的句柄。 |
copy_object |
EtsT_Obj_Handle |
原始属性对象副本的句柄。 |
返回类型
EtsT_Obj_Dbox_New_Value_Options
一个包含以下布尔值的结构:
dbox_refresh— 表示属性值已更改,属性显示必须刷新
use_default_set_method— 表示应用程序应使用标准的新值处理例程
invalid_value— 表示用户输入的值无效
头文件
ets_api_obj_dbox.h
详情
用户更改属性值后,应用程序会调用对象对话框新值处理器。新值处理器负责将用户输入转换为属性值并赋值给 copy_object。这对于设置采用字符串格式(如 “1,000”)、必须转换为有效属性设置的菜单尤其有用。你还可以使用该处理器更改受此次拟议更改影响的其他属性值,从而保证一致性。
如果点击处理函数已经定义了对话框,并以 EtsC_Obj_Dbox_Click_Show_Dbox 置为 PRGC_TRUE 的方式返回,则应用程序不会调用对象对话框新值处理器。(这种情况下,输入处理例程应由 ETS 对话框代码执行。)
你可以使用对象对话框新值处理器执行自定义校验——例如根据模型的状态执行动态校验。编写自定义校验例程时,将 invalid_value 标志置为 PRGC_TRUE 或 PRGC_FALSE,以指示新设置是否无效。
所有更改都应针对 copy_object 进行,而不是 orig_object,以便用户在需要时可以取消更改。你还应将 dbox_refresh 标志置为 PRGC_TRUE,表示属性显示必须刷新。
你可以使用对象对话框新值处理器替换对象属性对话框中的标准新值处理例程。这些例程通常负责校验用户输入并将其转换为有效的属性设置。要使用标准处理例程,只需以 use_default_set_method 标志置为 PRGC_TRUE 的方式返回。
此类回调在属性的 Enter ETS Handlers 对话框中注册为 New Value Handler(参见“Active Attributes“(第 51 页))。