UIDragDetector

사용되지 않는 항목 표시

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

UI드래거 디텍터 인스턴스는 사용자 인터페이스 요소와 상호 작용을 용이하게 하고 장려하며, 슬라이더 및 스핀너와 같은 경험에서 2D 사용자 인터페이스 요소와 상호 작용을 장려합니다. 주요 기능은 다음과 같습니다.

  • 단일 코드 없이 모든 입력을 드래그할 수 있도록 하려면 UIDragDetector 인스턴스 아래에 GuiObject를 배치하십시오.

  • 여러 가지 옵션 중에서 DragStyle 를 선택하세요, ResponseStyle 를 통해 개체가 이동에 대해 응답하는 방법을 정의하고 옵션적으로 축, 이동 제한 또는 드래그 경계를 적용하십시오.

  • 스크립트는 드래그 오브젝트를 조작하여 논리 응답을 드라이브하도록 응답할 수 있습니다. 예를 들어, 설정을 조정하는 등의 작업을 수행할 수 있습니다.

  • UIDragDetectors 은 Studio에서 작동하는 한 선택 , 이동 , 0>크기 조정0> 또는 3>회전3> 도구를 사용하지 않는 한 6>작동6> 합니다. UIDragDetectors9> 도구 또는 Studio의 UIDragDetectors0> 편

요약

속성

메서드

이벤트

속성

ActivatedCursorIcon

ContentId
병렬 읽기

UIDragDetector 의 부모에 마우스가 활성화되면 커서 아이콘을 표시합니다. 이 속성을 비워두면 감지기가 기본 아이콘을 사용합니다.

활성화된 커서 아이콘을 변경하려면 이 속성을 사용하려는 이미지의 자산 ID로 설정합니다.

병렬 읽기

감지기의 BoundingUI 가 설정되면 끌어 오는 개체의 바인딩 동작을 결정합니다. 각 설정의 동작에 대한 자세한 내용은 Enum.UIDragDetectorBoundingBehavior 를 참조하십시오.

BoundingUI

병렬 읽기

설정되면 UIDragDetector

참고 부모 GuiObject 의 일부가 바인딩 UI 의 경계 밖에 있으면 드래그 시작 시 및 드래그 동안의 상대 위치에서 드래그 개체의 초기 입력 위치와 상대 위치를 사용하여 바인딩 감지를 사용하면 드래그 개체 전체가 바인딩 내에 있는 경우에만 제한됩니다. 그

CursorIcon

ContentId
병렬 읽기

UIDragDetector 의 부모에 마우스가 있을 때 커서 아이콘을 표시하도록 합니다. 이 속성을 비워둘 경우 감지기는 기본 아이콘을 사용합니다.

커서 아이콘을 변경하려면 이 속성을 사용하려는 이미지의 자산 ID로 설정합니다.

DragAxis

병렬 읽기

Vector2 값은 끌어 오는 개체의 이동 축을 정의 하는 값입니다. DragStyleEnum.UIDragDetectorDragStyle.TranslateLine

병렬 읽기

Class.UIDragDetector:SetDragStyleFunction()|Class.UIDragDetector:AddConstraintFunction() 또는 AddConstraintFunction()를 통해 사용자 정의 드래그 함수를 등록하면 적용됩니다. 등록된 함수의 입력/출력의 관계를 정의하는 패러다임을 설정합니다.

DragRotation

병렬 읽기

현재 끌이 수행하는 회전. 이 값은 UIDragDetector 이 아닌 경우 ReferenceUIInstance 의 로컬 공간에 대한 회전 정도를 기준으로 정의됩니다. 이 경우 회전은 X 축의 로컬 공간에서 정의되며, 위치 기반 회

이 속성은 드래그 개체를 회전하기 위한 활성 드래그가 없는 동안 변경할 수 없습니다.

병렬 읽기

Class.UIDragDetector:SetDragStyleFunction()|Class.UIDragDetector:AddConstraintFunction() 또는 AddConstraintFunction()를 통해 사용자 정의 드래그 함수를 등록하면 적용됩니다. 등록된 함수의 입력/출력 공간을 정의하는 패러다임을 설정합니다.

예를 들어, 감지기의 부모 GuiObject 가 부모 GuiObject 의 자식이라면:

병렬 읽기

제안된 이동 생성에 사용된 모션 생성 패러다임, 입력 위치 벡터 스트림을 제공합니다. 옵션은 Enum.UIDragDetectorDragStyle 참조.

DragUDim2

병렬 읽기

현재 끌이 UDim2 값에 표시된 번역을 수행합니다. 번역은 Offset 또는 Scale

이 속성은 드래그 개체를 이동하는 활성 드래그가 없는 동안 변경할 수 없습니다.

Enabled

병렬 읽기

true 는 사용자 입력에 응답합니다; UIDragDetector 는 응답하지 않습니다.

MaxDragAngle

병렬 읽기

이 속성이 MinDragAngle 보다 크면 회전이 MinDragAngleMaxDragAngle 범위 내에 압도됩니다. 양수 값은 시계 방향으로 회전을 방지하고 음

이것은 제약 사항이 아닙니다; 그것은 단순히 감지기의 시도를 방해하여 한도 내에 유지하기 위해 이동을 생성하려는 시도를 방지합니다. 참조 AddConstraintFunction() 을 사용하여 드래그에 사용자 제약 함수를 추가하려면.

Class.UIDragDetector.DragStyle|DragStyle 이 Enum.UIDragDetectorDragStyle.Rotate 이면에 대해서만 유용합니다.

MaxDragTranslation

병렬 읽기

모든 차원에서 Offset 및/또는 Scale 값이 MinDragTranslation 및 2>Class.UI拖动器.最

이것은 제약 사항이 아닙니다; 그것은 단순히 감지기의 시도를 방해하여 한도 내에 유지하기 위해 이동을 생성하려는 시도를 방지합니다. 참조 AddConstraintFunction() 을 사용하여 드래그에 사용자 제약 함수를 추가하려면.

Only relevant if DragStyleEnum.UIDragDetectorDragStyle.TranslateLine 또는 Enum.UIDragDetectorDragStyle.TranslatePlane 이면.

MinDragAngle

병렬 읽기

이 속성이 MaxDragAngle 보다 작다면 회전이 MinDragAngleMaxDragAngle 범위 내에 압도됩니다. 양수 값은 시계 방향으로 회전을 방지하고 음수

이것은 제약 사항이 아닙니다; 그것은 단순히 감지기의 시도를 방해하여 한도 내에 유지하기 위해 이동을 생성하려는 시도를 방지합니다. 참조 AddConstraintFunction() 을 사용하여 드래그에 사용자 제약 함수를 추가하려면.

Class.UIDragDetector.DragStyle|DragStyle 이 Enum.UIDragDetectorDragStyle.Rotate 이면에 대해서만 유용합니다.

MinDragTranslation

병렬 읽기

모든 차원에서 Offset 및/또는 Scale 값이 MaxDragTranslation 보다 작다면 직선/평면 번

이것은 제약 사항이 아닙니다; 그것은 단순히 감지기의 시도를 방해하여 한도 내에 유지하기 위해 이동을 생성하려는 시도를 방지합니다. 참조 AddConstraintFunction() 을 사용하여 드래그에 사용자 제약 함수를 추가하려면.

Only relevant if DragStyleEnum.UIDragDetectorDragStyle.TranslateLine 또는 Enum.UIDragDetectorDragStyle.TranslatePlane 이면.

ReferenceUIInstance

병렬 읽기

Class.GuiObject 인스턴스의 로컬 공간과 센터 위치가 감지기의 참조 공간이 되는 경우. 이 참조는 속성을 변경하는 경우에 해당되는 속성 및 값에 대해 참조 공간을 설정합니다. 이 참조는 속성을 변

병렬 읽기

제안된 이동이 계산되고 잠재적으로 제한된 후, 이 패러다임은 GuiObject 에 영향을 미치는 UIDragDetector 를 이동하는 방법을 결정하는 데 사용됩니다. 옵션은 Enum.UIDragDetectorResponseStyle 에 참조되십시오.

SelectionModeDragSpeed

병렬 읽기

번역을 위한 최대 드래그 속도를 정의하는 최상위 조상 Scale 또는 Offset의 첫 번째 조상 ScreenGui 이 속도는 음수이어

SelectionModeRotateSpeed

병렬 읽기

IDragDetector 가 회전할 수 있는 최대 각도를 정의합니다. 이 값은 음수이어야 하고 아래의 값 0 이하는 0 에 고정됩니다.

UIDragSpeedAxisMapping

병렬 읽기

Enum.UIDragSpeedAxisMapping / Y 차원 끌기 속도를 결정하는 Enum.UIDragSpeedAxisMapping 값.

메서드

AddConstraintFunction

제안된 이동을 수정하거나 제한하려는 함수를 추가합니다. 이 함수는 입력 UDim2 (위치) 및 부동 소수점(회귀)의 제안된 이동과 부동 소수점(회귀)의 수정된</

입력은 DragSpace 속성의 델타 또는 원하는 위치/회전을 기반으로 표시되거나 해당 속성의 DragRelativity

추가 제약 함수를 제거하려면 Disconnect() 연결 개체에서 Disconnect()|Disconnect()를 호출하십시오.

매개 변수

priority: number

이 메서드를 사용하여 추가된 함수의 우선 순위 주문. 더 높은 값은 하위 값보다 우선 순위가 높습니다.

function: function

제안된 이동 개체를 수정하거나 제한하는 기능. 이 함수는 입력 UDim2 및 제안된 이동 개체의 부동 Datatype.UDim2 및 부동 Dat


반환

이 연결 개체를 사용하여 제약 함수를 제거합니다.

GetReferencePosition

Class.UIragDetector.ReferenceUIInstance|ReferenceUIInstance가 설정되지 않으면 이 함수는 드래그 개체의 즉시 부모 UDim2 (있는 경우) 또는 드래그 개체의 부모 GuiObject (있는 경우)의 위치를 반환합니다.

Class.UIDragDetector.ReferenceUIInstance|ReferenceUIInstance 가 설정되면 이 함수는 해당 참조 인스턴스의 UDim2 위치를 반환합니다.


반환

UDim2 현재 드래그의 참조 요소의 위치.

GetReferenceRotation

Class.UIragDetector.ReferenceUIInstance|ReferenceUIInstance 이 설정되지 않으면 이 함수는 드래그 개체의 즉시 부모인 GuiObject (또는 드래그 개체의 부모인 경우)를 돌리거나 드래그 개체의 부모인 경우 드래그 개체의 부모인 경우를 반환합니다.

Class.UIDragDetector.ReferenceUIInstance|ReferenceUIInstance가 설정되면 이 함수는 해당 참조 인스턴스의 회전을 반환합니다.


반환

현재 드래그의 참조 요소의 회전.

SetDragStyleFunction

void

Class.UIDragDetector.DragStyle|DragStyle 이 2개 이상의 드래그 모드를 지원하는 경우) 및 스크립트 타입 Datatype.

함수가 반환하는 경우 nil, 개체는 이동되지 않습니다. 이 기능은 스크립트가 올바른 답을 제공할 필요가 없거나 임시 상태에서 개체를 유지하려는 경우에 유용합니다.

매개 변수

function: function

함수는 모니터링 신호 DragContinue 신호를 모니터링합니다. 이 함수는 신호의 스크린 공간 입력 위치를 수신하고 원하는 드래그의 이동을 포함하는 데이터 형식을 반환합니다. 이 함수가 반환하는 경우 UDim2


반환

void

이벤트

DragContinue

Class.UIDragDetector.DragStart|DragStart 가 시작된 후 사용자가 UI 요소를 계속 끌면 화면이 켜집니다.

매개 변수

inputPosition: Vector2

Vector2 현재 입력 위치를 나타내는 데이터 타입 벡터.


DragEnd

사용자가 UI 요소를 드래그하지 않을 때 화면에 나타납니다.

매개 변수

inputPosition: Vector2

Vector2 현재 입력 위치를 나타내는 데이터 타입 벡터.


DragStart

사용자가 UI 요소를 드래그하기 시작하면 화면에 나타납니다.

매개 변수

inputPosition: Vector2

Vector2 현재 입력 위치를 나타내는 데이터 타입 벡터.