新值处理函数
摘要
使用该处理函数可以将用户输入转换为属性值,并将这些值复制到对象的一个副本。
语法
<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— 表示用户输入的值无效
详细说明
在用户更改属性值之后,应用程序会调用新值处理函数。新值处理函数负责将用户输入转换为属性值并赋值给 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。