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_ 开头的符号常量的后半部分。