UIDragDetector
*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.
Cú đỏ UIDragDetector instance facilitates and encourages interaction with 2D user interface elements in an experience, such as sliders and spinners. Key features include:
Đặt một UIDragDetector dưới bất kỳ GuiObject instância nào để làm cho nó có thể kéo không có dòng mã.
Chọn từ một số lựa chọn DragStyle , xác định cách mà thể đối tượng phản hồi đối với chuyển động bằng cách sử dụng ResponseStyle , và áp dụng các giới hạn chuyển động hoặc giới hạn kéo dài.
Scripts có thể đáp lại sự thao tác của các đối tượng kéo để lái đáp lại lý do, chẳng hạn như điều chỉnh cài đặt.
UIragDetectors hoạt động trong Studio miễn là bạn không sử dụng lựa chọn , di chuyển , 0> quy mô0> hoặc 3> quay3> các công cụ, hoặc một số plugin hoặc công cụ UIDragDetectors6> của Studio
Tóm Tắt
Thuộc Tính
Đặt biểu tượng chuột để hiển thị khi chuột được kích hoạt trên cha của thẻ này UIDragDetector .
Xác định hành vi giới hạn của đối tượng người dùng kéo khi điều khiển của người dùng được thiết cài đặt.
Instância whose bounding area defines the drag boundaries for the parent GuiObject .
Đặt biểu tượng chuột để hiển thị khi chuột đang giữ trên phụ huynh của thẻ này UIDragDetector .
Các trụ cơ khí cho UIDragDetector khi DragStyle được đặt vào Enum.UIDragDetectorDragStyle.TranslateLine .
Định nghĩa các khái niệm mà nói định tính độ lượng của các đầu vào/đầu ra từ chức năng kéo dẫn tùy chỉnh.
Sự quay tính của mắt hiện tại.
Định nghĩa các khái niệm mà tạo ra không gian của các đầu vào/đầu ra từ chức năng kéo tùy chỉnh.
Phương tiện được sử dụng để tạo ra chuyển động đề xuất.
Hành động dịch được thực hiện bởi giá trị dữ liệu UDim2 hiện tại.
Dù UIDragDetector có đáp lại vào nhập người dùng hay không.
Cùng với MinDragAngle , ngăn chặn những lần thử của máy dò để tạo ra chuyển động quay.
Cùng với MinDragTranslation, ngăn chặn những lần thử của máy dòng họa/phẳng của máy dòng họa.
Cùng với MaxDragAngle , ngăn chặn những lần thử của máy dò để tạo ra chuyển động quay.
Cùng với MaxDragTranslation , ngăn chặn những lần thử của máy dòng họa/linh kiện.
Một GuiObject instância cuộn dây và vị trí trung tâm tương đối là không gian lưu trữ và nguồn gốc cho máy dò dấu vết.
Khái niệm được sử dụng để định nghĩa phản ứng đối với chuyển động đề xuất.
Tốc độ kéo tối đa cho dịch.
Góc tối đa mỗi giây mà UIDragDetector có thể quay tại.
Enum.UIDragSpeedAxisMapping giá trị định vị tốc độ kéo dữ liệu X / Y .
Phương Pháp
Thêm chức năng để điều chỉnh hoặc hạn chế chuyển động đề xuất.
Điều chỉnh tham chiếu UDim2 của tham chiếu hiện tại.
Trả lại tham chiếu quay của tham chiếu hiện tại.
Tạo một chức năng để được sử dụng nếu và chỉ nếu DragStyle được đặt để Enum.UIDragDetectorDragStyle.Scriptable .
Sự Kiện
Lửa khi một người tiếp tục kéo thành phần UI sau khi đã kích hoạt DragStart .
Lửa khi người dùng dừng kéo thành phần UI.
Lửa khi một người bắt đầu kéo thành phần UI.
Thuộc Tính
ActivatedCursorIcon
Đặt icon cursors để hiển thị khi chuột được kích hoạt trên phụ huynh của thẻ này UIDragDetector . Nếu thuộc tính này được để trống, thì máy dò sẽ sử dụng biểu tượngmặc định.
Để thay đổi biểu tượng người dùng đang hoạt động, hãy tùy chỉnh thuộc tính này vào ID tài sản của hình ảnh bạn muốn sử dụng.
BoundingBehavior
Xác định hành vi giới hạn của đối tượng người dùng kéo khi thiết bị ngụy dược của detector được thiết lập. Xem BoundingUI để biết chi tiết về hành vi của mỗi cài đặt.
BoundingUI
Khi được cài đặt, UIDragDetector ví dụ / trường hợpsẽ không cho phép giới hạn của cha GuiObject được kéo ra ngoài giới hạn của instace BoundingUI .
Lưu ý rằng nếu một phần của cha GuiObject nằm ngoài giới hạn BoundingUI , vị trí nhập đầu tiên ở khi bắt đầu kéo và vị trí tương đối trong khi kéo sẽ được sử dụng để phát hiện liên kết cho đến khi toàn bộ k
CursorIcon
Đặt icon cursors để hiển thị khi chuột đang hoạt động trên phụ huynh của thẻ này UIDragDetector . Nếu thuộc tính này được để trống, thì máy dò sẽ sử dụng biểu tượngmặc định.
Để thay đổi biểu tượng chuột, hãy đặt thuộc tính này vào ID tài nguyên của hình ảnh bạn muốn sử dụng.
DragAxis
Vector2 giá trị mà định vị trục di chuyển cho đối tượng kéo khi DragStyle được đặt để Amount
DragRelativity
Chỉ áp dụng nếu chức năng kéo tùy chỉnh được đăng ký thông qua SetDragStyleFunction() hoặc AddConstraintFunction() . Thiết lập cấu hình mà định nghĩa sự tương đối của các đầu vào/thông đầ
DragRotation
Sự quay hướng thực hiện bởi cú đẩy hiện tại. Giá trị này được định nghĩa bằng độ so với không gian địa phương của UIDragDetector trừ khi ReferenceUIInstance được định nghĩa trong k
Điều này có thể được thay đổi khi không có thuộc tính kéo để quay vật thể kéo.
DragSpace
Chỉ áp dụng nếu chức năng kéo tùy chỉnh được đăng ký thông qua SetDragStyleFunction() hoặc AddConstraintFunction() . Thiết lập cấu hình mà định nghĩa không gian của hàm đăng ký.
Ví dụ, nếu cha của detector GuiObject là một con của cha GuiObject đó đã quay:
Returning a UDim2.fromOffset(1, 0) from a registered function with this property set to Enum.UIDragDetectorDragSpace.Parent will move the detector's parent GuiObject to the right by 1 pixel in the local space affected by its parent's rotation.
Returning a UDim2.fromOffset(1, 0) from a registered function with this property set to Enum.UIDragDetectorDragSpace.LayerCollector will move the detector's parent GuiObject to the right by 1 pixel in the space of the 1> Class.LayerCollector1> .
DragStyle
Phương tiện được sử dụng để tạo ra chuyển động đề xuất, cho một dòng vị trí đầu vào. Xem Enum.UIDragDetectorDragStyle cho tùy chọn.
DragUDim2
Cuộn dịch được thực hiện bởi các giá trị hiện tại của cuộn dịch biểu thị bằng một giá trị UDim2 . Cuộn dịch đượ
Điều này có thể được thay đổi khi không có một kéo để di chuyển đối tượng kéo.
MaxDragAngle
Nếu giá trị này lớn hơn MinDragAngle , thì sự quay sẽ được kẹp trong phạm vi MinDragAngle và MaxDragAngle . Các giá trị dương bị cản trở khi giá trị
Đây không phải là một hạn chế; nó chỉ làm trở ngại những nỗ lực của máy dòng chuyển động để được giữ trong giới hạn. Xem AddConstraintFunction() để thêm hạn chế tùy chỉnh cho một drag.
Chỉ liên quan nếu DragStyle là Enum.UIDragDetectorDragStyle.Rotate .
MaxDragTranslation
Nếu giá trị tương ứng ứng dụng được đề xuất Offset và/hoặc Scale lớn hơn giá trị tương
Đây không phải là một hạn chế; nó chỉ làm trở ngại những nỗ lực của máy dòng chuyển động để được giữ trong giới hạn. Xem AddConstraintFunction() để thêm hạn chế tùy chỉnh cho một drag.
Chỉ liên quan nếu DragStyle là Enum.UIDragDetectorDragStyle.TranslateLine hoặc Enum.UIDragDetectorDragStyle.TranslatePlane .
MinDragAngle
Nếu giá trị này nhỏ hơn MaxDragAngle , thì sự quay sẽ được kẹp trong phạm vi MinDragAngle và MaxDragAngle . Các giá trị dương bị cản trở khi
Đây không phải là một hạn chế; nó chỉ làm trở ngại những nỗ lực của máy dòng chuyển động để được giữ trong giới hạn. Xem AddConstraintFunction() để thêm hạn chế tùy chỉnh cho một drag.
Chỉ liên quan nếu DragStyle là Enum.UIDragDetectorDragStyle.Rotate .
MinDragTranslation
Nếu giá trị tương ứng Offset và/hoặc Scale được lấy từ Class.UIDragDetector.MaxDragTranslation|MaxDragTranslation
Đây không phải là một hạn chế; nó chỉ làm trở ngại những nỗ lực của máy dòng chuyển động để được giữ trong giới hạn. Xem AddConstraintFunction() để thêm hạn chế tùy chỉnh cho một drag.
Chỉ liên quan nếu DragStyle là Enum.UIDragDetectorDragStyle.TranslateLine hoặc Enum.UIDragDetectorDragStyle.TranslatePlane .
ReferenceUIInstance
Một GuiObject 实例 whose local space and absolute center position is the reference space and origin for the detector. Đặt điều này ảnh hưởng đến các thuộc tính như DragUDim2 , Class.UIDragDetector.DragVolume|DragVolume
ResponseStyle
Một khi những chuyển động được tính toán và có thể bị hạn chế, kiểu dự đoán này được sử dụng để xác định cách di chuyển (hoặc không di chuyển) GuiObject ảnh hưởng bởi UIDragDetector . Xem Enum.UIDragDetectorResponseStyle kiểu dự đoán cho
SelectionModeDragSpeed
Định nghĩa tốc độ kéo tối đa cho dịch bằng cách kết hợp Scale và Offset của người tiề
SelectionModeRotateSpeed
Định nghĩa góc tối đa mỗi giây mà UIDragDetector có thể quay. Giá trị này phải là dương và bất kỳ giá trị dưới 0 sẽ được kéo dài đến 0 .
Phương Pháp
AddConstraintFunction
Thêm một chức năng để điều chỉnh hoặc hạn chế di chuyển đề xuất. Chức năng nhận một đầu vào UDim2 (vị trí) và float (xoay) của đề xuất</
Nhập được biểu hiện trong không gian được định nghĩa bởi thuộc tính DragSpace , hoặc như một kích thước hoặc v
Để loại bỏ một chức năng hạn chế đã được thêm, hãy gọi Disconnect() trên các thể hiện kết nối đã trả lại.
Tham Số
Lệ thuộc trên ưu tiên cho các hàm được thêm bằng cách này. Giá trị càng cao càng được ưu tiên hơn.
Lợi Nhuận
Sử dụng đối tượng kết nối này để loại bỏ chức năng hạn chế.
GetReferencePosition
Khi không có ReferenceUIInstance được cài đặt, chức năng này sẽ trả về vị trí UDim2 của người cha trực tiếp của đối tượng kéo GuiObject (nếu có), hoặc else vị tr
Khi một ReferenceUIInstance được cài đặt, chức năng này trả về vị trí UDim2 của hồ ví dụ / trường hợptham chiếu đó.
Lợi Nhuận
GetReferenceRotation
Khi không có ReferenceUIInstance được cài đặt, chức năng này trả về sự quay của thẻ ngay lập tức của đối tượng đã kéo (nếu có), hoặc sự quay của thẻ ngay lập tức của đối tượng đã kéo (nếu có).
Khi một ReferenceUIInstance được cài đặt, chức năng này trả lại sự quay của tham ví dụ / trường hợpđó.
Lợi Nhuận
Quay mối quan hệ tham chiếu của thả bằng cách hiện tại.
SetDragStyleFunction
Lưu một chức năng để được sử dụng nếu và chỉ nếu Class.UI
Nếu hàm nil trả về, thì đối tượng sẽ không được di chuyển. Điều này hữu ích nếu script chưa thu thập được tất cả các thông tin cần thiết để đưa ra câu trả lời chính xác, hoặc trong các trường hợp tạm thời mà bạn muốn đối tượng ở lại nơi nó đã ở.
Tham Số
Chức năng để theo dõi DragContinue các tín hiệu. Đây chức năng nhận vị trí trên màn hình của singal và trả lại một UDim2 và float chứa động tối đa trong không gian và sự
Lợi Nhuận
Sự Kiện
DragEnd
Lửa khi người dùng dừng kéo thành phần UI.