UIDragDetector

Hiển Thị Bản Đã Lỗi Thời

*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

Phương Pháp

Sự Kiện

Thuộc Tính

ActivatedCursorIcon

ContentId
Đọc Song Song

Đặ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.

Đọc Song Song

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

Đọc Song Song

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

ContentId
Đọc Song Song

Đặ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

Đọc Song Song

Vector2 giá trị mà định vị trục di chuyển cho đối tượng kéo khi DragStyle được đặt để Amount

Đọc Song Song

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

Đọc Song Song

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.

Đọc Song Song

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:

Đọc Song Song

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

Đọc Song Song

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.

Enabled

Đọc Song Song

Nếu true, thì UIDragDetector đáp lại sự nhập력 của người dùng; nếu false, thì không.

MaxDragAngle

Đọc Song Song

Nếu giá trị này lớn hơn MinDragAngle , thì sự quay sẽ được kẹp trong phạm vi MinDragAngleMaxDragAngle . 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 DragStyleEnum.UIDragDetectorDragStyle.Rotate .

MaxDragTranslation

Đọc Song Song

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 DragStyleEnum.UIDragDetectorDragStyle.TranslateLine hoặc Enum.UIDragDetectorDragStyle.TranslatePlane .

MinDragAngle

Đọc Song Song

Nếu giá trị này nhỏ hơn MaxDragAngle , thì sự quay sẽ được kẹp trong phạm vi MinDragAngleMaxDragAngle . 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 DragStyleEnum.UIDragDetectorDragStyle.Rotate .

MinDragTranslation

Đọc Song Song

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 DragStyleEnum.UIDragDetectorDragStyle.TranslateLine hoặc Enum.UIDragDetectorDragStyle.TranslatePlane .

ReferenceUIInstance

Đọc Song Song

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

Đọc Song Song

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

Đọc Song Song

Định nghĩa tốc độ kéo tối đa cho dịch bằng cách kết hợp ScaleOffset của người tiề

SelectionModeRotateSpeed

Đọc Song Song

Đị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 .

UIDragSpeedAxisMapping

Đọc Song Song

Enum.UIDragSpeedAxisMapping giá trị định vị tốc độ kéo dữ liệu X / Y .

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ố

priority: number

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.

function: function

Chức năng để điều chỉnh hoặc hạn chế di chuyển đề xuất. Đây là chức năng nhận UDim2 và float của động và trả kết quả <


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

UDim2 vị trí của thành phần tham chiếu của cuộn dịch hiện tại.

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

void

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ố

function: function

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

void

Sự Kiện

DragContinue

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 .

Tham Số

inputPosition: Vector2

Vector2 đại diện vị trí nhập hiện tại.


DragEnd

Lửa khi người dùng dừng kéo thành phần UI.

Tham Số

inputPosition: Vector2

Vector2 đại diện vị trí nhập hiện tại.


DragStart

Lửa khi một người bắt đầu kéo thành phần UI.

Tham Số

inputPosition: Vector2

Vector2 đại diện vị trí nhập hiện tại.