UIDragDetector

Pokaż przestarzałe

*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

Instancja UIDragDetector ułatwia i zachęca do interakcji z elementami interfejsu użytkownika 2D w doświadczeniu, takimi jak przełączniki i spinnery. Key features include:

  • Umieść UIDragDetector pod dowolną instancją GuiObject, aby uczynić go przeciąganym poprzez wszystkie wejścia bez pojedynczej linii kodu.

  • Wybierz z kilku opcji DragStyle, zdefiniuj, jak reaguje obiekt na ruch poprzez ResponseStyle i opcjonalnie zastosuj ograniczenia pracy w obrębie lub granice przesuwania.

  • Skrypty mogą reagować na manipulację przeciągniętymi obiektami, aby zachować odpowiedzi logiczne, takie jak dostosowanie ustawień.

  • UIragDetectors pracy w Studio tak długo, jak jesteś nie używając narzędzia Wybierz , 0>Przenieś0>, 3>Skala3> lub narzędzia UIDragDetectors6> Studio, lub niektóre plugin lub narzędzia Studio.

Podsumowanie

Właściwości

Metody

Zdarzenia

Właściwości

ActivatedCursorIcon

ContentId
Odczyt równoległy

Ustawia ikonę kursora do wyświetlenia, gdy myszka jest aktywna nad rodzicem tego UIDragDetector . Jeśli ta właściwość pozostanie pusta, wykryjnik będzie używał domyślnej ikona.

Aby zmienić aktywowany ikona, ustaw ten właściwość na ID zasobu obrazu, którego chcesz użyć.

Odczyt równoległy

Określa zachowanie graniczne obiektu przeciągniętego interfejsu użytkownika, gdy BoundingUI detektora jest ustawiać. Zobacz Enum.UIDragDetectorBoundingBehavior dla szczegółów każdego ustawienie.

BoundingUI

Odczyt równoległy

Gdy ustawiać, instans UIDragDetector nie pozwoli na przecięcie granic GuiObject poza granice BoundingUI instancja.

Uwaga, jeśli część GuiObject jest poza granicami BoundingUI, początkowa pozycja wejścia przy startowaniu i jej relatywne pozycja podczas przeciągania będą używane do wykrywania powiązania, dopóki cały obiekt przeciągania będzie w granicach, a następnie obiekt będzie skonfigurowany wewnątrz granic.

CursorIcon

ContentId
Odczyt równoległy

Ustawia ikonę kursora do wyświetlenia, gdy myszka jest położona nad ojcem tego UIDragDetector . Jeśli ta właściwość pozostanie pusta, wykryjnik użyje domyślnej ikona.

Aby zmienić ikonakursora, ustaw tę właściwość na ID zasobu, którego chcesz użyć.

DragAxis

Odczyt równoległy

Vector2 wartość, która określa osi ruchu dla przeciągniętego obiektu, gdy DragStyle jest ustawiony na Enum.UIDragDetectorDragStyle.TranslateLine</

Odczyt równoległy

Stosuje się tylko w przypadku, jeśli zarejestrowana funkcja przeciągania jest zarejestrowana za pośrednictwem SetDragStyleFunction() lub AddConstraintFunction(). Ustawia parametr, który określa relatywność wejść/wyjść zarejestrowanej funkcji.

Na przy

DragRotation

Odczyt równoległy

Rotacja wykonana przez obecny dostosowywacz. Ta wartość jest zdefiniowana w stopniach względem lokalnej przestrzeni Class.IDDragDetector|ReferenceUIInstance , chyba że ReferenceUIInstance nie jest zdefiniowany, w którym przypadku rotacja zostaje zdefiniowana w lokalnej przestrzeni tego instancji i z jej pozytywnego X osi.

Ta właściwość może być zmieniona, gdy nie ma aktywnego przeciągnięcia, aby obrócić przeciągnięty obiekt.

Odczyt równoległy

Stosuje się tylko w przypadku, gdy zarejestrowana funkcja przeciągania jest zarejestrowana za pośrednictwem SetDragStyleFunction() lub AddConstraintFunction(). Ustawia parametr, który określa przestrzeń wejść/wyjść zapisu funkcji rejestrowanej.

Na przykład, jeśli rodzice GuiObject są dzieckiem rodzica GuiObject , który jest obrócony:

Odczyt równoległy

Paradigma używana do generowania proponowanego kierunku ruchu, z zestawem wektorów pozycji wejścia. Patrz Enum.UIDragDetectorDragStyle dla opcji.

DragUDim2

Odczyt równoległy

Tłumaczenie wykonane przez bieżący przeciąg wyrażony w wartości UDim2. Tłumaczenie jest wykonane poprzez zmianę wartości Offset lub Datatype.UD

Ta właściwość może być zmieniona, gdy nie ma aktywnego przeciągnięcia, aby przenieść przeciągnięty obiekt.

Enabled

Odczyt równoległy

Jeśli true, UIDragDetector reaguje na wejście użytkownika; jeśli false, nie reaguje.

MaxDragAngle

Odczyt równoległy

Jeśli wartość ta jest większa niż MinDragAngle , to rotacja zostanie przycięta w zakresie MinDragAngle i MaxDragAngle. Pozytywne wartości zapobiegają obrotowi w kierunku zegarowym, a negatyw

To nie jest ograniczeniem; po prostu zapobiega próbom wykrywacza generowania ruchu, aby pozostać w ramach. Zobacz AddConstraintFunction(), aby dodać niestandardowy ograniczony dodatek do koszyka.

Tylko istotne, jeśli DragStyle jest Enum.UIDragDetectorDragStyle.Rotate .

MaxDragTranslation

Odczyt równoległy

Jeśli wartości Offset i/lub Scale są większe niż wartości MinDragTranslation w wszystkich wymiarach, to tłumienie

To nie jest ograniczeniem; po prostu zapobiega próbom wykrywacza generowania ruchu, aby pozostać w ramach. Zobacz AddConstraintFunction(), aby dodać niestandardowy ograniczony dodatek do koszyka.

Tylko istotne, jeśli DragStyle jest Enum.UIDragDetectorDragStyle.TranslateLine lub Enum.UIDragDetectorDragStyle.TranslatePlane .

MinDragAngle

Odczyt równoległy

Jeśli właściwość jest mniejsza niż MaxDragAngle , to rotacja zostanie przycięta w zakresie MinDragAngle i MaxDragAngle . Pozytywne wartości zapobiegają obrotowi w kierunku pozytywnym

To nie jest ograniczeniem; po prostu zapobiega próbom wykrywacza generowania ruchu, aby pozostać w ramach. Zobacz AddConstraintFunction(), aby dodać niestandardowy ograniczony dodatek do koszyka.

Tylko istotne, jeśli DragStyle jest Enum.UIDragDetectorDragStyle.Rotate .

MinDragTranslation

Odczyt równoległy

Jeśli wartości odpowiadające Offset i/lub Scale są mniejsze niż wartości MaxDragTranslation w wszystkich

To nie jest ograniczeniem; po prostu zapobiega próbom wykrywacza generowania ruchu, aby pozostać w ramach. Zobacz AddConstraintFunction(), aby dodać niestandardowy ograniczony dodatek do koszyka.

Tylko istotne, jeśli DragStyle jest Enum.UIDragDetectorDragStyle.TranslateLine lub Enum.UIDragDetectorDragStyle.TranslatePlane .

ReferenceUIInstance

Odczyt równoległy

Przypadkowe przestrzeń GuiObject lokalna przestrzeń i pozycja środka są przestrzenią odniesienia i miejscem pochodzenia dla detektora. Ustawienie tego przestrzeń DragUDim2 , DragRotation i zachowanie 1>

Odczyt równoległy

Gdy proponowany ruch zostanie obliczony i prawdopodobnie ograniczony, ten paradgmat używany jest do określenia, jak poruszać (lub nie poruszać) GuiObject dotkniętego przez UIDragDetector. Zobacz Enum.UIDragDetectorResponseStyle dla opcji.

SelectionModeDragSpeed

Odczyt równoległy

Definiuje maksymalną prędkość przetwarzania tłumaczenia jako kombinację Scale i Offset pierwszych przodków ScreenGui lub 1>

SelectionModeRotateSpeed

Odczyt równoległy

Definiuje maksymalny kąt na sekundę, w którym UIDragDetector może się obrócić. Ta wartość musi być pozytywna, a wszelka wartość poniżej 0 zostanie skrócona do 0 .

UIDragSpeedAxisMapping

Odczyt równoległy

Enum.UIDragSpeedAxisMapping wartość, która określa prędkości przesuwania w wymiarach X / Y .

Metody

AddConstraintFunction

Dodaje funkcję do modyfikacji lub ograniczenia proponowanej animacji. Funkcja odbiera wejście UDim2 (pozycja) i pływanie (rotacja) proponowanej animacji i w zwrotuje UDim2 i pływanie modyfikowane

Wejście jest wyrażone w przestrzeni zdefiniowanej przez właściwość DragSpace, jako deltę lub pożądane pozycję/rotację na podstawie właściwości Class.UIDragDetectorDragRelocity|DragRelativity</

Aby usunąć dodaną funkcję ograniczenia, wezwij Disconnect() na zwróconym obiekcie połączenia.

Parametry

priority: number

Zamówienie priorytetu dla funkcji dodanych za pomocą tego metody. Wyższe wartości mają pierwszeństwo nad niższymi wartościami.

function: function

Funkcja do modyfikacji lub ograniczenia proponowanej animacji. Ta funkcja przyjmuje wejście UDim2 i float of proponowanej animacji i wygibt UDim2 i float of


Zwroty

Użyj tego obiektu połączenia, aby usunąć funkcję ograniczenia.

GetReferencePosition

Gdy nie jest ustawiaćżaden ReferenceUIInstance, ta funkcja zwraca pozycję UDim2 w bezpośrednim podręczniku przeciągniętego obiektu GuiObject (jeśli istnieje), lub wraca pozycję 2>Datatype.UDim22> w przeciągniętym

Gdy ReferenceUIInstance jest ustawiać, funkcja ta zwraca pozycję UDim2 tej instancji instancja.


Zwroty

UDim2 pozycja elementu referencji obecnego zapisu.

GetReferenceRotation

Gdy nie jest ustawiaćżaden ReferenceUIInstance , funkcja ta zwraca obrót bezpośredniego ojca przeciągniętego obiektu GuiObject (jeśli istnieje), lub obrót przeciągniętego obiektu.

Gdy ReferenceUIInstance jest ustawiać, funkcja ta zwraca obrót tej instancji instancja.


Zwroty

Rotacja elementu referencji obecnego zapisu.

SetDragStyleFunction

void

Przekazuje funkcję do użycia, jeśli i tylko jeśli DragStyle zostanie ustawiony na 枚.UI

Jeśli funkcja zwraca nil , obiekt nie zostanie przesunięty. To jest użyteczne, jeśli skrypt jeszcze nie zebrał wszystkich informacji, które są niezbędne, aby dać poprawną odpowiedź, lub w przypadkach tymczasowych, w których chcesz, aby obiekt pozostał gdzie jest.

Parametry

function: function

Funkcja do monitorowania DragContinue sygnałów. Ta funkcja otrzymuje pozycję przestrzeni ekratu singala i wysyła UDim2 i pływający zawierający pożądaną pozycję ruchu w pożądanym przestrzeń i relatywności. Jeśli funkcja ta zwraca nil </


Zwroty

void

Zdarzenia

DragContinue

Wyst?puje, gdy u?ytkownik nadal przeciąga element UI po DragStart, który zosta? uruchomiony.

Parametry

inputPosition: Vector2

Vector2 reprezentujący obecną pozycję wejścia.


DragEnd

Wystąpi, gdy użytkownik przestanie przeciągającym element UI.

Parametry

inputPosition: Vector2

Vector2 reprezentujący obecną pozycję wejścia.


DragStart

Wystąpi, gdy użytkownik zacznie przeciągnąć element UI.

Parametry

inputPosition: Vector2

Vector2 reprezentujący obecną pozycję wejścia.