UI드래거 디텍터 인스턴스는 사용자 인터페이스 요소와 상호 작용을 용이하게 하고 장려하며, 슬라이더 및 스핀너와 같은 경험에서 2D 사용자 인터페이스 요소와 상호 작용을 장려합니다. 주요 기능은 다음과 같습니다.
단일 코드 없이 모든 입력을 드래그할 수 있도록 하려면 UIDragDetector 인스턴스 아래에 GuiObject를 배치하십시오.
여러 가지 옵션 중에서 DragStyle 를 선택하세요, ResponseStyle 를 통해 개체가 이동에 대해 응답하는 방법을 정의하고 옵션적으로 축, 이동 제한 또는 드래그 경계를 적용하십시오.
스크립트는 드래그 오브젝트를 조작하여 논리 응답을 드라이브하도록 응답할 수 있습니다. 예를 들어, 설정을 조정하는 등의 작업을 수행할 수 있습니다.
UIDragDetectors 은 Studio에서 작동하는 한 선택 , 이동 , 0>크기 조정0> 또는 3>회전3> 도구를 사용하지 않는 한 6>작동6> 합니다. UIDragDetectors9> 도구 또는 Studio의 UIDragDetectors0> 편
요약
속성
이 UIDragDetector 의 부모에 마우스가 활성화되면 커서 아이콘을 표시합니다.
감지기의 BoundingUI 가 설정된 경우 끌어 오는 UI 개체의 바인딩 동작을 결정합니다.
바인딩 영역이 부모 GuiObject 에 대한 드래그 경계를 정의하는 인스턴스입니다.
이 UIDragDetector 의 부모에 마우스가 있을 때 커서 아이콘을 표시하도록 설정합니다.
Class.UIDragDetector.DragStyle|DragStyle 인스턴스의 드래그 축을 설정하면 DragStyle 드래그 스타일을 Enum.UIDragDetectorDragStyle.TranslateLine 으로 변환합니다.
사용자 지정 드래그 함수의 입력/출력을 정의하는 논리를 설정합니다.
현재 끌어 수행하는 회전.
사용자 지정 드래그 함수에서 입력/출력 공간을 정의하는 패러다임을 설정합니다.
제안된 움직임을 생성하는 데 사용되는 패러다임입니다.
현재 끌어 식에 표시된 값에 대해 수행된 번역.
UserDragDetector 가 사용자 입력에 응답합니다.
Class.UI드래그 상세 정보 도구.MinDragAngle|MinDragAngle 와 함께 사용하면 감지기의 회전 이동 생성 시도를 방지합니다.
Class.UIDragDetector.MinDragTranslation|MinDragTranslation 과 함께 사용하면 감지기의 시도로 직선/평면 이동을 생성하는 것을 방지합니다.
Class.UI드래그 디텍터.맥스 드래그 앵글|맥스 드래그 앵글 과 함께 사용하면 감지기의 회전 운동을 생성하는 시도를 방지합니다.
Class.UI드래그 디텍터.맥스 드래그 트랜스포메이션|맥스 드래그 트랜스포메이션 과 함께 사용하면 감지기의 시도를 방지하여 직선/평면 이동을 생성하는 것을 방지합니다.
Class.GuiObject 인스턴스의 경우 로컬 공간과 센터 위치가 감지기의 참조 공간이 되는 경우.
제안된 움직임에 대한 응답을 정의하는 데 사용되는 패러다임입니다.
번역에 대한 최대 드래그 속도.
ID拖动器 는 초당 최대 각도를 회전할 수 있습니다.
Enum.UIDragSpeedAxisMapping / Y 차원 끌기 속도를 결정하는 Enum.UIDragSpeedAxisMapping 값.
메서드
제안된 이동을 수정하거나 제한하는 함수를 추가합니다.
현재 드래그의 참조 원의 참조 위치를 반환합니다. UDim2
현재 드래그의 참조 요소의 참조 회전을 반환합니다.
Class.UIDragDetector.DragStyle|DragStyle 가 Enum.UIDragDetectorDragStyle.Scriptable 로 설정된 경우에만 사용할 함수를 패스합니다.
이벤트
Class.UIDragDetector.DragStart|DragStart 가 시작된 후 사용자가 UI 요소를 계속 끌면 화면이 켜집니다.
사용자가 UI 요소를 드래그하지 않을 때 화면에 나타납니다.
사용자가 UI 요소를 드래그하기 시작하면 화면에 나타납니다.
속성
ActivatedCursorIcon
이 UIDragDetector 의 부모에 마우스가 활성화되면 커서 아이콘을 표시합니다. 이 속성을 비워두면 감지기가 기본 아이콘을 사용합니다.
활성화된 커서 아이콘을 변경하려면 이 속성을 사용하려는 이미지의 자산 ID로 설정합니다.
BoundingBehavior
감지기의 BoundingUI 가 설정되면 끌어 오는 개체의 바인딩 동작을 결정합니다. 각 설정의 동작에 대한 자세한 내용은 Enum.UIDragDetectorBoundingBehavior 를 참조하십시오.
BoundingUI
설정되면 UIDragDetector
참고 부모 GuiObject 의 일부가 바인딩 UI 의 경계 밖에 있으면 드래그 시작 시 및 드래그 동안의 상대 위치에서 드래그 개체의 초기 입력 위치와 상대 위치를 사용하여 바인딩 감지를 사용하면 드래그 개체 전체가 바인딩 내에 있는 경우에만 제한됩니다. 그
CursorIcon
이 UIDragDetector 의 부모에 마우스가 있을 때 커서 아이콘을 표시하도록 합니다. 이 속성을 비워둘 경우 감지기는 기본 아이콘을 사용합니다.
커서 아이콘을 변경하려면 이 속성을 사용하려는 이미지의 자산 ID로 설정합니다.
DragAxis
Vector2 값은 끌어 오는 개체의 이동 축을 정의 하는 값입니다. DragStyle 가 Enum.UIDragDetectorDragStyle.TranslateLine
DragRelativity
Class.UIDragDetector:SetDragStyleFunction()|Class.UIDragDetector:AddConstraintFunction() 또는 AddConstraintFunction()를 통해 사용자 정의 드래그 함수를 등록하면 적용됩니다. 등록된 함수의 입력/출력의 관계를 정의하는 패러다임을 설정합니다.
예
DragRotation
현재 끌이 수행하는 회전. 이 값은 UIDragDetector 이 아닌 경우 ReferenceUIInstance 의 로컬 공간에 대한 회전 정도를 기준으로 정의됩니다. 이 경우 회전은 X 축의 로컬 공간에서 정의되며, 위치 기반 회
이 속성은 드래그 개체를 회전하기 위한 활성 드래그가 없는 동안 변경할 수 없습니다.
DragSpace
Class.UIDragDetector:SetDragStyleFunction()|Class.UIDragDetector:AddConstraintFunction() 또는 AddConstraintFunction()를 통해 사용자 정의 드래그 함수를 등록하면 적용됩니다. 등록된 함수의 입력/출력 공간을 정의하는 패러다임을 설정합니다.
예를 들어, 감지기의 부모 GuiObject 가 부모 GuiObject 의 자식이라면:
이 속성 집합에 대해 등록된 함수에서 UDim2.fromOffset(1, 0)를 반환하면 감지기의 부모인 Enum.UIDragDetectorDragSpace.Parent를 로컬 공간에서 부모의 회전에 따라 1픽셀 이동시킵니다.
이 속성 집합을 사용하여 등록된 함수에서 UDim2.fromOffset(1, 0)를 반환하면 센서의 부모 Enum.UIDragDetectorDragSpace.LayerCollector가 공간의 GuiObject에 1픽셀 이동하게 됩니다.
DragUDim2
현재 끌이 UDim2 값에 표시된 번역을 수행합니다. 번역은 Offset 또는 Scale 값
이 속성은 드래그 개체를 이동하는 활성 드래그가 없는 동안 변경할 수 없습니다.
MaxDragAngle
이 속성이 MinDragAngle 보다 크면 회전이 MinDragAngle 및 MaxDragAngle 범위 내에 압도됩니다. 양수 값은 시계 방향으로 회전을 방지하고 음
이것은 제약 사항이 아닙니다; 그것은 단순히 감지기의 시도를 방해하여 한도 내에 유지하기 위해 이동을 생성하려는 시도를 방지합니다. 참조 AddConstraintFunction() 을 사용하여 드래그에 사용자 제약 함수를 추가하려면.
Class.UIDragDetector.DragStyle|DragStyle 이 Enum.UIDragDetectorDragStyle.Rotate 이면에 대해서만 유용합니다.
MaxDragTranslation
모든 차원에서 Offset 및/또는 Scale 값이 MinDragTranslation 및 2>Class.UI拖动器.最
이것은 제약 사항이 아닙니다; 그것은 단순히 감지기의 시도를 방해하여 한도 내에 유지하기 위해 이동을 생성하려는 시도를 방지합니다. 참조 AddConstraintFunction() 을 사용하여 드래그에 사용자 제약 함수를 추가하려면.
Only relevant if DragStyle 이 Enum.UIDragDetectorDragStyle.TranslateLine 또는 Enum.UIDragDetectorDragStyle.TranslatePlane 이면.
MinDragAngle
이 속성이 MaxDragAngle 보다 작다면 회전이 MinDragAngle 및 MaxDragAngle 범위 내에 압도됩니다. 양수 값은 시계 방향으로 회전을 방지하고 음수
이것은 제약 사항이 아닙니다; 그것은 단순히 감지기의 시도를 방해하여 한도 내에 유지하기 위해 이동을 생성하려는 시도를 방지합니다. 참조 AddConstraintFunction() 을 사용하여 드래그에 사용자 제약 함수를 추가하려면.
Class.UIDragDetector.DragStyle|DragStyle 이 Enum.UIDragDetectorDragStyle.Rotate 이면에 대해서만 유용합니다.
MinDragTranslation
모든 차원에서 Offset 및/또는 Scale 값이 MaxDragTranslation 보다 작다면 직선/평면 번
이것은 제약 사항이 아닙니다; 그것은 단순히 감지기의 시도를 방해하여 한도 내에 유지하기 위해 이동을 생성하려는 시도를 방지합니다. 참조 AddConstraintFunction() 을 사용하여 드래그에 사용자 제약 함수를 추가하려면.
Only relevant if DragStyle 이 Enum.UIDragDetectorDragStyle.TranslateLine 또는 Enum.UIDragDetectorDragStyle.TranslatePlane 이면.
ReferenceUIInstance
Class.GuiObject 인스턴스의 로컬 공간과 센터 위치가 감지기의 참조 공간이 되는 경우. 이 참조는 속성을 변경하는 경우에 해당되는 속성 및 값에 대해 참조 공간을 설정합니다. 이 참조는 속성을 변
ResponseStyle
제안된 이동이 계산되고 잠재적으로 제한된 후, 이 패러다임은 GuiObject 에 영향을 미치는 UIDragDetector 를 이동하는 방법을 결정하는 데 사용됩니다. 옵션은 Enum.UIDragDetectorResponseStyle 에 참조되십시오.
SelectionModeRotateSpeed
IDragDetector 가 회전할 수 있는 최대 각도를 정의합니다. 이 값은 음수이어야 하고 아래의 값 0 이하는 0 에 고정됩니다.
메서드
AddConstraintFunction
제안된 이동을 수정하거나 제한하려는 함수를 추가합니다. 이 함수는 입력 UDim2 (위치) 및 부동 소수점(회귀)의 제안된 이동과 부동 소수점(회귀)의 수정된</
입력은 DragSpace 속성의 델타 또는 원하는 위치/회전을 기반으로 표시되거나 해당 속성의 DragRelativity
추가 제약 함수를 제거하려면 Disconnect() 연결 개체에서 Disconnect()|Disconnect()를 호출하십시오.
매개 변수
이 메서드를 사용하여 추가된 함수의 우선 순위 주문. 더 높은 값은 하위 값보다 우선 순위가 높습니다.
반환
이 연결 개체를 사용하여 제약 함수를 제거합니다.
GetReferencePosition
Class.UIragDetector.ReferenceUIInstance|ReferenceUIInstance가 설정되지 않으면 이 함수는 드래그 개체의 즉시 부모 UDim2 (있는 경우) 또는 드래그 개체의 부모 GuiObject (있는 경우)의 위치를 반환합니다.
Class.UIDragDetector.ReferenceUIInstance|ReferenceUIInstance 가 설정되면 이 함수는 해당 참조 인스턴스의 UDim2 위치를 반환합니다.
반환
GetReferenceRotation
Class.UIragDetector.ReferenceUIInstance|ReferenceUIInstance 이 설정되지 않으면 이 함수는 드래그 개체의 즉시 부모인 GuiObject (또는 드래그 개체의 부모인 경우)를 돌리거나 드래그 개체의 부모인 경우 드래그 개체의 부모인 경우를 반환합니다.
Class.UIDragDetector.ReferenceUIInstance|ReferenceUIInstance가 설정되면 이 함수는 해당 참조 인스턴스의 회전을 반환합니다.
반환
현재 드래그의 참조 요소의 회전.
SetDragStyleFunction
Class.UIDragDetector.DragStyle|DragStyle 이 2개 이상의 드래그 모드를 지원하는 경우) 및 스크립트 타입 Datatype.
함수가 반환하는 경우 nil, 개체는 이동되지 않습니다. 이 기능은 스크립트가 올바른 답을 제공할 필요가 없거나 임시 상태에서 개체를 유지하려는 경우에 유용합니다.
매개 변수
함수는 모니터링 신호 DragContinue 신호를 모니터링합니다. 이 함수는 신호의 스크린 공간 입력 위치를 수신하고 원하는 드래그의 이동을 포함하는 데이터 형식을 반환합니다. 이 함수가 반환하는 경우 UDim2
반환
이벤트
DragContinue
Class.UIDragDetector.DragStart|DragStart 가 시작된 후 사용자가 UI 요소를 계속 끌면 화면이 켜집니다.
매개 변수
DragEnd
사용자가 UI 요소를 드래그하지 않을 때 화면에 나타납니다.