点击处理函数
摘要
使用该处理函数可以指明应用程序在用户单击属性名称时的响应方式:执行该属性的默认操作、打开对话框,或打开拉下菜单。
语法
<click handler name> (attr_name, orig_object, copy_object, menu_tlptr)
| 参数 | 类型 | 说明 |
|---|---|---|
attr_name |
const char* |
用户单击的属性名称 |
orig_object |
EtsT_Obj_Handle |
原始属性对象的句柄 |
copy_object |
EtsT_Obj_Handle |
原始属性对象副本的句柄 |
menu_tlptr |
Prg_List* |
指向文本列表的指针,该列表包含该属性当前定义的符号值;如果该属性允许其他值,还包含 “Other…” 字符串 |
返回类型
EtsT_Obj_Dbox_Click_Options
一个包含以下布尔值的结构:
EtsC_Obj_Dbox_Click_Default——表示该处理函数已为该属性执行了默认操作。EtsC_Obj_Dbox_Click_Show_Dbox——表示该处理函数显示了 ETS 对话框以处理用户输入,并可能修改了该属性。EtsC_Obj_Dbox_Click_Show_Menu——表示该处理函数基于 menu_tlptr 所引用的列表显示了拉下菜单,并可能修改了该属性。
详细说明
点击处理函数决定应用程序在用户于 Edit Attributes 对话框中单击属性名称时的响应。属性对话框可以采用三种形式之一:为该属性执行默认操作、打开拉下菜单,或打开自定义 ETS 对话框。返回值必须准确反映所采取的操作。
应用程序在调用点击处理函数时会自动传入 attr_name、orig_object、copy_object 和 menu_tlptr 参数。
如果点击处理函数打开 ETS 对话框,应将任何输入处理例程(例如检查无效输入)与对话框代码一起包含在点击处理函数内部。
如果点击处理函数打开拉下菜单,当用户更改属性值时,应用程序会调用新值处理函数(new value handler)。因此,针对菜单的任何输入处理例程都应放在新值处理函数中,而不是点击处理函数中。
拉下菜单反映 menu_tlptr 所引用的文本列表。你必须确保该处理函数初始化此指针以引用合适的列表。无需在此处理函数内释放列表内容。
要让应用程序为某个属性执行默认对话框,只需让点击处理函数返回时将 EtsC_Obj_Dbox_Click_Default 设为 PRGC_TRUE。