SinglePointHandler QML Type

可激活此指针处理程序的鼠标按钮。

默认情况下，该属性设置为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 。

可激活该指针处理程序的指向工具类型（手指、触控笔、橡皮等）。

默认情况下，该属性设置为PointerDevice.AllPointerTypes 。如果将其设置为设备类型的 OR 组合，则会忽略来自非匹配devices 的事件。

例如，一个控件可以通过两种处理程序对鼠标、触摸和手写笔点击作出某种响应，但如果用绘图板上的橡皮擦工具点击，则会自行删除：

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

每当该输入处理程序独自负责处理一个或多个eventPoints 时，它都会通过成功地独占这些点来保持true 。这意味着该输入处理程序会根据这些事件点的移动更新其属性，并积极操作其target （如有）。

当鼠标悬停在parent 项目上时，该属性会显示光标形状，同时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

默认值未设置，允许cursor 的parent 项目出现。可通过将该属性设置为未定义来将其重置为相同的初始状态。

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

用户必须拖动eventPoint 才能被视为拖动手势的距离（以像素为单位）。

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

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

当处理程序的逻辑决定接管独占抓取时，或者当处理程序被其他处理程序要求批准接管或取消抓取时，该属性会指定权限。

默认值为PointerHandler.CanTakeOverFromItems | PointerHandler.CanTakeOverFromHandlersOfDifferentType | PointerHandler.ApprovesTakeOverByAnything ，允许大多数抓取场景，但也避免了两个 PinchHandler 争夺同一接触点的情况。

parent 项目边界以外的余量，在此范围内eventPoint 可以激活此处理程序。例如，在PinchHandler 上，如果target 也是parent ，那么将其设置为至少相当于一般用户手指宽度一半的距离是非常有用的，这样，如果parent 被缩小到非常小的尺寸，仍然可以使用捏合手势。或者，如果基于TapHandler 的按钮放置在屏幕边缘附近，则可用于遵守菲茨定律：即使按钮与屏幕边缘在视觉上相差几个像素，也会对屏幕边缘的鼠标点击做出反应。

默认值为 0。

Item 是处理程序的作用域；也就是在其中声明的项目。处理程序将代表该 Item 处理事件，这意味着如果指针事件中至少有一个eventPoints 出现在该 Item 的内部，那么该指针事件就是相关的。最初target() 是相同的，但可以重新分配。

另请参阅 target 和QObject::parent()。

当前正在处理的eventPoint 。如果当前没有正在处理的点，该对象将重置为默认值（所有坐标均为 0）。

该处理程序将处理的项目。

默认情况下，它与parent 相同，即处理程序所声明的 Item。不过，有时也可以将目标设置为不同的项目，以便处理一个项目中的事件，但同时操作另一个项目；或者将目标设置为null ，禁用默认行为并执行其他操作。

如果该处理程序已经抓取了给定的point ，那么当抓取被其他指针处理程序或项窃取时，就会发出该信号。

当抓取发生与该处理程序相关的某种变化时，就会发出该信号。

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

transition 的有效值是