EtsT_Obj_Dbox_Click_Handler
摘要
回调:用于指示应用程序在用户点击属性名称时的响应方式:执行该属性的默认操作、打开对话框,或打开下拉菜单。
语法
<object_dbox_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 所引用的列表显示了下拉菜单,并可能修改了该属性。
头文件
ets_api_obj_dbox.h
详情
对象对话框点击处理器决定应用程序在用户于 Edit Attributes 对话框中点击属性名称时的响应。属性对话框可以有三种形式:执行该属性的默认操作、打开下拉菜单,或打开自定义 ETS 对话框。返回值必须准确反映所采取的操作。
应用程序在调用对象对话框点击处理器时会自动传入 attr_name、orig_object、copy_object 和 menu_tlptr 参数。
如果对象对话框点击处理器打开了 ETS 对话框,应将任何输入处理例程(例如检查无效输入)与对话框代码一起放在点击处理器内部。
如果对象对话框点击处理器打开了下拉菜单,当用户修改属性值时,应用程序会调用新值处理器(EtsT_Obj_Dbox_New_Value_Handler)。因此,菜单的任何输入处理例程应放在新值处理器中,而不是放在对象对话框点击处理器中。
下拉菜单反映 menu_tlptr 所引用的文本列表。你必须确保处理程序将该指针初始化为引用合适的列表。在此处理程序内无需释放列表内容的内存。
要让应用程序执行某属性的默认对话框,只需让对象对话框点击处理器在 EtsC_Obj_Dbox_Click_Default 设为 PRGC_TRUE 的状态下返回。
此类回调在属性的 Enter ETS Handlers 对话框中注册为 Click Handler(参见“Active Attributes“(第 51 页))。