EtsT_Ctl_Tree_Drag_Drop_Proc

注意: 需要 OPNET Development Kit

摘要

回调:在树拖放操作期间按需调用,以执行相关操作。

语法

<tree_drag_drop_proc_name> (src_ctl_ptr, dest_ctl_ptr, drop_point, tree_nodes_lptr, drop_op, options)
参数 类型 说明
src_ctl_ptr EtsT_Ctl * 拖出对象所在的控件。
dest_ctl_ptr EtsT_Ctl * 对象正被放置到的目标控件。
drop_point EtsT_Point * 对象正被放置到的控件位置点。
tree_nodes_lptr PrgT_List * 发起拖拽时被选中的树节点列表。
drop_op EtsT_Ctl_Tree_Drag_Drop_Op 正在进行的拖放操作;表 20 回调符号常量 中给出的值之一。
options int 留作将来使用。

返回类型

EtsT_Boolean

EtsC_True 或 EtsC_False,取决于回调所确定的拖放状态。返回值的含义取决于 drop_op 的值;更多信息见详情。

头文件

ets_api_gui.h

详情

该回调执行自定义处理以支持树拖放操作。该回调应支持由 drop_op 参数指定的四种操作类型。表 19 列出了这些操作及预期的返回值。

表 19:树拖放操作

操作¹ 说明 返回值的含义:EtsC_True 返回值的含义:EtsC_False
Initiate_Drag 树拖拽开始时调用。回调应执行树拖放所需的预处理。这可用于限定被拖拽的对象,或在特定条件下阻止拖拽。 可以继续拖放。 不要继续拖放。
Query 树拖拽过程中光标移动时调用。回调应确定光标是否位于有效的放置位置。 光标位于有效的放置点。 光标位于无效的放置点。
Drop 树拖放过程中释放鼠标按钮时调用。回调应确定光标是否位于有效位置,若是,则通过将拖拽的对象安装到目标处完成放置。 放置成功。 放置失败。
Abort 用户中止拖放时调用。回调应撤销此前执行的相关处理。 拖放已成功中止。 拖放无法中止。

注 1:这些操作代表以 EtsC_Ctl_Tree_Drag_Drop_Op_ 开头的符号常量的后半部分。

此类回调由 Ets_Ctl_Tree_Drag_Drop_Callback_Register() 注册。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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