UIDragDetector
*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
Ustawia ikonę kursora, aby była wyświetlana, gdy myszka jest aktywna nad rodzicielską tego UIDragDetector .
Określa zachowanie graniczne obiektu przeciągniętego interfejsu użytkownika, gdy BoundingUI jest ustawiać.
Instancja, która określa granice przeciągania dla rodzica GuiObject .
Ustawia ikonę kursora, aby wyświetlić, gdy myszka jest nad nim kursorem UIDragDetector .
Oś przeciągania dla instancji UIDragDetector gdy DragStyle jest ustawiony na Enum.UIDragDetectorDragStyle.TranslateLine .
Definiuje paraдиgmat, który określa relatywność wejść/wyjść z niestandardowej funkcji przeciągania.
Rotacja wykonana przez bieżący dostęp.
Zdefiniowuje paradigma, które określa przestrzeń wejść/wyjść z niestandardowej funkcji przeciągania.
Paradigma używana do generowania proponowanych ruchów.
Tłumaczenie wykonane przez bieżący przeciąg wyrażony w wartości UDim2.
Czy UIDragDetector reaguje na wejście użytkownika.
Wraz z MinDragAngle , zapobiega próbom generatora ruchu rotacyjnego.
Wraz z MinDragTranslation , zapobiega próbom generatora ruchu liniowego/planezarnego.
Wraz z MaxDragAngle , zapobiega próbom generatora ruchu rotacyjnego.
Wraz z MaxDragTranslation , zapobiega próbom generatora ruchu liniowego/planeznego.
Instancja GuiObject, która ma lokalną przestrzeń i absolutną pozycję środka, jest przestrzenią odniesienia i źródłem dla detektora.
Paradigma używana do definicji odpowiedzi na proponowany ruch.
Maksymalna szybkość przetwarzania.
Maksymalny kąt na sekundę, który może obrócić UIDragDetector .
Enum.UIDragSpeedAxisMapping wartość, która określa prędkości przesuwania w wymiarach X / Y .
Metody
Dodaje funkcję do modyfikacji lub ograniczenia proponowanego ruchu.
Zwraca pozycję referencji UDim2 pozycji referencji bieżącej przeciągnięcia.
Zwraca referencję rotacji obiektu przeciągu aktualnego.
Przekaż funkcję do użycia, jeśli i tylko jeśli DragStyle jest ustawiony na Enum.UIDragDetectorDragStyle.Scriptable.
Zdarzenia
Wyst?puje, gdy u?ytkownik nadal przeciąga element UI po DragStart, który zosta? uruchomiony.
Wystąpi, gdy użytkownik przestanie przeciągającym element UI.
Wystąpi, gdy użytkownik zacznie przeciągnąć element UI.
Właściwości
ActivatedCursorIcon
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ć.
BoundingBehavior
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
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
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
Vector2 wartość, która określa osi ruchu dla przeciągniętego obiektu, gdy DragStyle jest ustawiony na Enum.UIDragDetectorDragStyle.TranslateLine</
DragRelativity
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
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.
DragSpace
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:
Powrót UDim2.fromOffset(1, 0) zarejestrowanej funkcji z tym ustawieniem właściwości do Enum.UIDragDetectorDragSpace.Parent będzie przesuwać rodzicielkę detektorów GuiObject do prawy o 1 piksela w przestrzeni lokalnej dotkniętej przez rotację jego rodzica.
Powrót UDim2.fromOffset(1, 0) z rejestrowanej funkcji z tym ustawieniem w Enum.UIDragDetectorDragSpace.LayerCollector przesuwa o 1 pixel w przestrzeni Class.层CollectorDragSpace.L层Collector .
DragStyle
Paradigma używana do generowania proponowanego kierunku ruchu, z zestawem wektorów pozycji wejścia. Patrz Enum.UIDragDetectorDragStyle dla opcji.
DragUDim2
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.
MaxDragAngle
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
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
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
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
Przypadkowe przestrzeń GuiObject lokalna przestrzeń i pozycja środka są przestrzenią odniesienia i miejscem pochodzenia dla detektora. Ustawienie tego przestrzeń DragUDim2 , DragRotation i zachowanie 1>
ResponseStyle
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
Definiuje maksymalną prędkość przetwarzania tłumaczenia jako kombinację Scale i Offset pierwszych przodków ScreenGui lub 1>
SelectionModeRotateSpeed
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
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
Zamówienie priorytetu dla funkcji dodanych za pomocą tego metody. Wyższe wartości mają pierwszeństwo nad niższymi wartościami.
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
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
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
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
Zdarzenia
DragContinue
Wyst?puje, gdy u?ytkownik nadal przeciąga element UI po DragStart, który zosta? uruchomiony.
Parametry
DragEnd
Wystąpi, gdy użytkownik przestanie przeciągającym element UI.