概要
属性
将鼠标指针设置为显示父鼠标下的 UIDragDetector 。
确定拖动 UI 对象的边界行为,当探测器的 BoundingUI 设置为。
实例 whose 边界定义了拖动边界为父 GuiObject 。
将鼠标悬停在此 UIDragDetector 的父级上设置鼠标标记。
当 DragStyle 设置为 Enum.UIDragDetectorDragStyle.TranslateLine 时,拖动轴为 1> UI拖动器.拖动样式.TranslateLine1> 。
设置定义自定义拖动函数的相对性的参照理论。
当前拖动执行的旋转。
设置定义自定义拖动函数输入/输出空间的方法。
用于生成所提出的移动的方法。
当前拖动在 UDim2 值表达的翻译。
UIDragDetector 是否会回应用户输入。
以及 MinDragAngle ,阻止探测器的尝试生成旋转运动。
以及 MinDragTranslation ,阻止探测器尝试生成直线/平面运动。
以及 MaxDragAngle , 阻止探测器的尝试生成旋转运动。
以及 MaxDragTranslation , 阻止探测器的尝试生成直线/平面运动。
一个 GuiObject 实例,其本地空间和绝对中心位置是探测器的引用空间和起始位置。
用于定义所提出的运动的回应的方法。
最大翻译速度。
UIドラッグディテクタ 每秒可以旋转最大角度。
Enum.UIDragSpeedAxisMapping 值,决定 X / Y 维度拖动速度。
方法
添加一个函数来修改或限制提出的移动。
返回当前拖动引用位置的参考 UDim2。
返回当前拖动元素的引用旋转元素的引用旋转元素。
如果 DragStyle 设置为 Enum.UIDragDetectorDragStyle.Scriptable ,则通过使用以下函数使用:
活动
在 DragStart 已初始化后,用户继续拖动 UI 元素时触发。
当用户停止拖动 UI 元素时,火焰会熄灭。
当用户开始拖动 UI 元素时,火焰会立即点燃。
属性
ActivatedCursorIcon
将鼠标悬停图标设置为显示,当鼠标激活在此父子 UIDragDetector 下。如果此属性为空,探测器将使用默认标志。
要更改激活的鼠标标志,将此属性设置为您想要使用的图像的资产 ID 。
BoundingBehavior
确定拖动 UI 对象的边界行为,当探测器的 BoundingUI 设置为可设置。请参阅 Enum.UIDragDetectorBoundingBehavior 了解每个设置的详细信息。
BoundingUI
设置时,UIDragDetector实例不会允许父级GuiObject的边界拖出 界面 实例的边界。
注意,如果父级 GuiObject 的一部分在 边界界面 之外,父级 Class.Gui 的初始输入位置在拖动开始时使用,并在拖动过程中的相对位置使用来检测边界检测,直到拖动对象的整个内部,然后对象将被限制在边界内。
CursorIcon
将鼠标悬停在此 UIDragDetector 的父级上时,显示鼠标标志。如果此属性为空,探测器将使用默认图标。
要更改鼠标标志,将此属性设置为您想要使用的图像的资产 ID 。
DragAxis
Vector2 值,定义拖动对象的移动轴,当 DragStyle 设置为 Enum.UIDragDetectorDragStyle.TranslateLine 。轴在本地空间的 0> UIDragDet
DragRelativity
仅适用于通过 SetDragStyleFunction() 或 AddConstraintFunction() 注册定义了关系的输入/输出的函数。设置注册函数的参照理论。
例如
DragRotation
当前拖动执行的旋转。这个值是在 UIDragDetector 本地空间的相对度数,除非 ReferenceUIInstance 定义,在那里旋转是在该实例的本地空间和从其正向 X 轴定义的。
这个属性可以在没有激活拖动对象旋转的拖动对象时更改。
DragSpace
仅适用于通过 SetDragStyleFunction() 或 AddConstraintFunction() 注册定义空间的函数。设置注册函数的输入/输出的空间。
例如,如果探测器的父级 GuiObject 是一个旋转的父级 GuiObject 的子级,
从注册的函数中返回一个 UDim2.fromOffset(1, 0) ,从这个属性设置为 Enum.UIDragDetectorDragSpace.Parent 将探测器的父亲移动到本地空间中受到父元素亲旋转影响的 1 像移动到右侧。
从注册的函数中返回一个 UDim2.fromOffset(1, 0) 以此属性设置为 Enum.UIDragDetectorDragSpace.LayerCollector 的父级,将探测器的父级 GuiObject 移动到空间 1> Class.层Collector1> 的右侧 1 像。
MaxDragAngle
如果此属性大于 MinDragAngle ,旋转将被压缩在 MinDragAngle 和 MaxDragAngle 之间。正向值会阻止时钟旋转,负向值会阻止反时钟旋转。
这不是限制;它只是阻止探测器尝试生成移动以保持在限制内。请参阅 AddConstraintFunction() 来添加自定义约束到拖动。
仅适用于 DragStyle 是 Enum.UIDragDetectorDragStyle.Rotate 的旋转。
MaxDragTranslation
如果相应的 Offset 和/或 Scale 值大于 MinDragTranslation 在所有尺寸上的范围内,交叉线/平面
这不是限制;它只是阻止探测器尝试生成移动以保持在限制内。请参阅 AddConstraintFunction() 来添加自定义约束到拖动。
仅适用于 DragStyle 是 Enum.UIDragDetectorDragStyle.TranslateLine 或 Enum.UIDragDetectorDragStyle.TranslatePlane 。
MinDragAngle
如果此属性小于 MaxDragAngle ,旋转将被压缩在 MinDragAngle 和 MaxDragAngle 之间。正向值会阻止时钟旋转,而负向值会阻止反时钟旋转。
这不是限制;它只是阻止探测器尝试生成移动以保持在限制内。请参阅 AddConstraintFunction() 来添加自定义约束到拖动。
仅适用于 DragStyle 是 Enum.UIDragDetectorDragStyle.Rotate 的旋转。
MinDragTranslation
如果相应的 Offset 和/或 Scale 值小于 MaxDragTranslation 在所有尺寸上的范围内,交叉线/平面
这不是限制;它只是阻止探测器尝试生成移动以保持在限制内。请参阅 AddConstraintFunction() 来添加自定义约束到拖动。
仅适用于 DragStyle 是 Enum.UIDragDetectorDragStyle.TranslateLine 或 Enum.UIDragDetectorDragStyle.TranslatePlane 。
ReferenceUIInstance
一个 GuiObject 实例的本地空间和绝对中心位置是探测器的参考空间和起始位置。设置此参考会影响属性,例如 DragUDim2 、 DragRotation 和 1> Class.
ResponseStyle
一旦该建议的运动已被计算并可能受到限制,此模式用于确定如何移动 (或不移动工具) 受到 GuiObject 影响的 UIDragDetector。请参阅 Enum.UIDragDetectorResponseStyle 获取选项。
方法
AddConstraintFunction
添加一个函数来修改或限制所提出的移动。该函数接受一个输入UDim2 (位置)和漂浮 (旋转) 的所提出的移动,并返回一个 Datatype.UDim2 和漂浮的UDim2或未改进的移动。您可以添加多个函
输入以 DragSpace 属性定义的空间为输入空间,或作为第三个或第四个返回值,在 DragRelativity 属性上。输出应该以同一个空间和重力,除非
要将添加的限制函数移除,请在返回的连接对象上调用 Disconnect()。
参数
添加函数的优先级订单。更高的值取得优先权。
返回
使用此连接对象来移除限制函数。
GetReferencePosition
当没有 ReferenceUIInstance 设置时,此函数将返回拖动对象的父级 UDim2 (如果存在) 的位置,或者返回拖动对象的父级 GuiObject (如果存在)。
当 ReferenceUIInstance 设置时,此函数将返回该引用实例的 UDim2 位置。
返回
GetReferenceRotation
当没有 ReferenceUIInstance 设置,此函数将旋转拖动对象的父亲 GuiObject (如果存在) 或返回拖动对象的旋转。
当 ReferenceUIInstance 设置时,此函数将返回该引用实例的旋转。
返回
旋转当前拖动的引用元素。
SetDragStyleFunction
如果 DragStyle 设置为 枚.UI
如果函数返回 nil ,对象不会移动。这对于脚本尚未收集到正确答案所需的所有信息有用,或在暂时情况下您想要对象保留在原位。
参数
监控DragContinue 信号. 此函数接受单个的屏幕空间输入位置并返回一个 UDim2 和漂浮在指定空间和重力中的拖动. 如果此函数返回 nil, 对象将不会移动.