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 页))。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com