菜单显示处理函数
摘要
用于指定应用程序在用户右键点击某个对象时的响应自定义菜单。
语法
Menu Display Handler Function Name (obj_handle, menu_item_list_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
obj_handle |
EtsT_Obj_Handle |
被点击对象的句柄。 |
menu_item_list_ptr |
PrgT_List |
指向待显示菜单项列表的指针。 |
返回类型
EtsT_Obj_Click_Return
以下常量之一:
EtsC_Obj_Click_Continue——表示应用程序应继续处理该点击,即显示菜单。EtsC_Obj_Click_Handled——表示该点击已被处理,应用程序不应再进行任何后续处理。
详细说明
菜单显示处理函数允许模型开发者修改 ODK 应用程序在用户右键点击某个对象时显示的对象弹出菜单。如果为某个对象指定了菜单显示处理函数,当用户右键点击该对象时,应用程序会调用该函数。该函数接收对象句柄,以及一个由字符串组成的列表,即应用程序打算向用户显示的菜单内容。
菜单显示处理函数可以更改菜单内容或执行其他处理。如果该函数返回 EtsC_Obj_Click_Continue,ODK 应用程序会显示菜单并让用户从中选择一项。此外,如果还指定了菜单选择处理器,当用户从菜单中做出选择时,应用程序会调用该处理器函数。
如果菜单显示处理函数返回 EtsC_Obj_Click_Handled,则右键点击事件被"消耗",不会显示任何菜单。