DragHandler QML 类型

可以激活此指针处理器的鼠标按钮。

默认情况下，此属性设置为 Qt.LeftButton。可以将其设置为鼠标按钮的 OR 组合，并将忽略来自其他按钮的事件。

例如，可以使用两个处理器将控制按钮以不同方式响应用户的左键和右键点击。

Item {
    TapHandler {
        onTapped: console.log("left clicked")
    }
    TapHandler {
        acceptedButtons: Qt.RightButton
        onTapped: console.log("right clicked")
    }
}

可以激活此指针处理器的指针设备类型。

默认情况下，此属性设置为 PointerDevice.AllDevices。将其设置为设备类型的 OR 组合后，它将忽略不匹配的设备事件。

例如，可以使用两个处理器将控制按钮以不同方式响应用户的鼠标和笔触点击，以及触摸屏的点击。

Item {
   TapHandler {
       acceptedDevices: PointerDevice.Mouse | PointerDevice.TouchPad | PointerDevice.Stylus
       onTapped: console.log("clicked")
   }
   TapHandler {
       acceptedDevices: PointerDevice.TouchScreen
       onTapped: console.log("tapped")
   }
}

如果设置了此属性，则需要按下给定的键盘修饰符才能对指针事件做出反应，否则将忽略这些事件。

如果此属性设置为 Qt.KeyboardModifierMask（默认值），则 PointerHandler 将忽略修饰键。

例如，一个 Item 可以有两个相同类型的处理器，其中一个是只有当所需键盘修饰符被按下时才启用。

Item {
   TapHandler {
       acceptedModifiers: Qt.ControlModifier
       onTapped: console.log("control-tapped")
   }
   TapHandler {
       acceptedModifiers: Qt.NoModifier
       onTapped: console.log("tapped")
   }
}

将 acceptedModifiers 设置为修饰键的 OR 组合意味着 所有 这些修饰符必须被按下才能激活处理器。

Item {
   TapHandler {
       acceptedModifiers: Qt.ControlModifier | Qt.AltModifier | Qt.ShiftModifier
       onTapped: console.log("control-alt-shift-tapped")
   }
}

可用的修饰符如下所示：

如果您需要的复杂行为超过了通过多个处理器和多个修饰标志的组合所能实现的行为，您可以在JavaScript代码中检查修饰键

Item {
    TapHandler {
        onTapped:
            switch (point.modifiers) {
            case Qt.ControlModifier | Qt.AltModifier:
                console.log("CTRL+ALT");
                break;
            case Qt.ControlModifier | Qt.AltModifier | Qt.MetaModifier:
                console.log("CTRL+META+ALT");
                break;
            default:
                console.log("other modifiers", point.modifiers);
                break;
            }
    }
}

另请参见 Qt::KeyboardModifier.

该Pointer Handler可以激活的类型指向设备（手指、笔、橡皮擦等）。

默认情况下，此属性设置为PointerDevice.AllPointerTypes。如果您将其设置为设备类型的OR组合，它将忽略不匹配设备的事件。

例如，可以使用两个处理器在某种方式上使控件响应鼠标、触摸和笔点击，但如果在绘图板上用橡皮擦工具轻拍则删除控件。

Rectangle {
   id: rect
   TapHandler {
       acceptedPointerTypes: PointerDevice.Generic | PointerDevice.Finger | PointerDevice.Pen
       onTapped: console.log("clicked")
   }
   TapHandler {
       acceptedPointerTypes: PointerDevice.Eraser
       onTapped: rect.destroy()
   }
}

每次此输入处理器独立负责处理一个或多个eventPoints时，它就会保持为true，通过成功占用这些点的独占抓取。这意味着它正在根据这些事件点的移动保持其属性最新，并正在积极地操作其目标（如果有的话）。

在执行拖动手势过程中进行的平移。在手势开始时，它是0, 0，在将事件点向下和向右拖动时增加。在手势结束后，它保持相同；在下一个拖动手势开始时，它重新设置为0, 0。

该属性保存当鼠标在<码 translate="no">active true时悬停在父项上时出现的光标形状。

可用的光标形状为

• Qt.ArrowCursor
• Qt.UpArrowCursor
• Qt.CrossCursor
• Qt.WaitCursor
• Qt.IBeamCursor
• Qt.SizeVerCursor
• Qt.SizeHorCursor
• Qt.SizeBDiagCursor
• Qt.SizeFDiagCursor
• Qt.SizeAllCursor
• Qt.BlankCursor
• Qt.SplitVCursor
• Qt.SplitHCursor
• Qt.PointingHandCursor
• Qt.ForbiddenCursor
• Qt.WhatsThisCursor
• Qt.BusyCursor
• Qt.OpenHandCursor
• Qt.ClosedHandCursor
• Qt.DragCopyCursor
• Qt.DragMoveCursor
• Qt.DragLinkCursor

默认值未设置，这允许光标显示父项。此属性可以通过将其设置为未定义来重置为初始条件。

另请参见 Qt::CursorShape、QQuickItem::cursor()和HoverHandler::cursorShape。

为了使事件点被视为拖动手势，用户必须将其拖动指定像素数的距离。

默认值取决于平台和屏幕分辨率。可以通过将其设置为未定义来将其重置为默认值。拖拽手势开始时的行为在不同的事件处理程序中有所不同。

如果禁用了PointerHandler，它将拒绝所有事件，并且不会发出任何信号。

当该处理程序逻辑决定获取独家抓取或被另一个处理程序请求批准抓取转移或取消时，此属性指定权限。

默认值是PointerHandler.CanTakeOverFromItems | PointerHandler.CanTakeOverFromHandlersOfDifferentType | PointerHandler.ApprovesTakeOverByAnything，这允许大多数接管场景，但避免了例如两个PinchHandlers为相同的触摸点而相互竞争的情况。

在此处理程序可以激活的eventPoint超出parent项界限的外边缘。例如，在一个PinchHandler中，如果target也是parent，将其设置为至少是典型用户手指宽度的一半的距离是有用的，这样即使用户将parent缩小到非常小的尺寸，捏合手势仍然可以进行。或者，如果基于TapHandler的按钮放置在屏幕边缘附近，它可以用作遵守Fitts定律：即使按钮在视觉上被几个像素隔离开，也可以对边缘的鼠标点击做出反应。

默认值是0。

作为处理程序作用域的Item；声明它的项。处理程序将代表此项处理事件，这意味着如果至少有一个eventPoint在项的内部发生，则指针事件才是相关的。初始时target()相同，但可以进行重新赋值。

另请参阅 target 和 QObject::parent。

当它不是null时，将应用此翻译到目标。否则，可以使用绑定对这个值执行任意操作。在拖动操作进行时，activeTranslation会持续添加到其中；手势结束后，它保持不变。

此属性持有快照模式。

快照模式配置了目标项中心相对于事件点的吸附。

可能值

此处理器将要操作的Item。

默认情况下，它与父项相同，即处理器在其中声明的项内的项。但是，有时将目标设置为不同的项可能很有用，以便在一个项内处理事件但操纵另一个项；或者设置为null，以禁用默认行为并执行其他操作。

xAxis控制水平拖动的约束。

minimum是应用到x属性上的最小可接受值。 maximum是应用到x属性上的最大可接受值。如果enabled为true，允许水平拖动。activeValue与activeTranslation.x相同。

当activeValue改变时，发出activeValueChanged信号，以提供变化的增量。这是通过多个处理器增量调整一个属性的方式。

yAxis控制垂直拖动的约束。

minimum是应用到y属性上的最小可接受值。 maximum是应用到y属性上的最大可接受值。如果enabled为true，允许垂直拖动。activeValue与activeTranslation.y相同。

当 activeValue 发生变化时，会发出 activeValueChanged 信号，以提供变化的增量。这是用于通过多个处理程序逐步调整一个属性的。

import QtQuick

Rectangle {
    width: 50; height: 200

    Rectangle {
        id: knob
        width: parent.width; height: width; radius: width / 2
        anchors.centerIn: parent
        color: "lightsteelblue"

        Rectangle {
            antialiasing: true
            width: 4; height: 20
            x: parent.width / 2 - 2
        }

        WheelHandler {
            property: "rotation"
        }
    }

    DragHandler {
        target: null
        dragThreshold: 0
        yAxis.onActiveValueChanged: (delta)=> { knob.rotation -= delta }
    }
}

如果此处理程序已经抓取了给定的 point，当捕获被不同的指针处理程序或元素窃取时，这个信号会被发出。

当捕获在该处理程序中发生了某种相关变化时，会发出此信号。

transition（动词）说明了发生了什么。point（对象）是已被抓取或取消抓取的点。

transition的有效值包括