作用
DragHandler 是用于处理拖放操作的一个交互处理组件,它可以方便地为 Item 类型的对象添加拖放功能。无需手动处理事件逻辑。
简单示例:
Window {id: rootwidth: 600height: 400visible: trueRectangle {width: 100height: 100color: "lightsteelblue"DragHandler { }}
}
在这个例子中,我们在Window中嵌入了一个Rectangle,矩形组件里面直接嵌入DragHandler组件,运行发现就可以直接拖动了,而无需其他实现。
要求版本:
import QtQuick 2.12
常用属性
1 target
指定要进行拖放操作的目标项。如果不指定,默认为其父项。
2 active
用于控制 DragHandler 是否处于活动状态。当 active 为 false 时,拖放操作将被禁用。
3 acceptedButtons
指定哪些鼠标按钮可以触发拖放操作,默认值为 Qt.LeftButton
4 xAxis 与 yAxis
设置拖拽方向
xAxis.enabled: true // 启用水平拖拽
yAxis { enabled: true; minimum: 0; maximum: 300 } // 限制垂直范围
5 dragThreshold
触发拖拽的最小像素移动(默认为0,立即响应),可避免误触。
6 cursorShape
拖拽时鼠标光标样式