GuiButton
*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.
GuiButton jest abstrakcyjną klasą, która dziedziczy od GuiObject.Jest to klasa podstawowa dla interaktywnych, klikalnych obiektów ImageButton i TextButton.Klasa ta określa również kilka właściwości dla zachowania interaktywnego, mianowicie AutoButtonColor i Modal.
Najważniejszym wydarzeniem w jest , wieloplatformowe wydarzenie, które uruchamia się, gdy przycisk jest aktywowany.Podczas używania myszy oznacza to kliknięcie przycisku i uwolnienie za pomocą kurora nadal nad obiektem UI.Dla dotknięcia, to samo ma zastosowanie, ale z dotknięciem zamiast naciskaćprzycisku.Wreszcie, dla gamepadów, Activated wystrzeliwuje, jeśli GuiButton zostanie wybrany, gdy naciśnięto i uwolniono przycisk A .Krótko mówiąc, to wydarzenie jest bardzo przydatne do programowania interfejsu użytkownika wieloplatformowego, ponieważ zapewnia miły ogólny interfejs dla jednego wejścia użytkownika.
Podsumowanie
Właściwości
Określa, czy przycisk automatycznie zmienia kolor, gdy mysz przewija się nad nim lub klika na niego.
Instancja HapticEffect, która zagra, gdy GuiButton zostanie przewieszona.
Jeśli true podczas gdy element GUI jest widoczny, mysz nie zostanie zamknięta, chyba że prawy przycisk myszy jest w dół.
Instancja HapticEffect, która zagra, gdy naciśnięto GuiButton.
Właściwość booleanowa, która wskazuje, czy obiekt został wybrany.
Ustawia styl GuiButton w oparciu o listę wcześniej określonych stylów.
Określa, czy ten element interfejsu zanurza wejście.
Określa punkt pochodzenia GuiObject , względem jego absolutnego rozmiaru.
Określa, czy zmiana rozmiaru następuje w oparciu o treść dziecka.
Określa kolor tła GuiObject.
Określa przejrzystość tła i ramki GuiObject.
Określa kolor obramowania GuiObject.
Określa, w jaki sposób granica GuiObject jest rozmieszczona względem jej wymiarów.
Określa szerokość piksela obramowania GuiObject.
Określa, czy potomek GuiObjects poza granicami elementu GUI rodzica powinien się renderować.
Określa, czy mysz gracza jest aktywnie naciśnięta na GuiObject lub nie.
Określa, czy GuiButton można wejść w interakcję, czy nie, lub czy GuiState z GuiObject zmienia się lub nie.
Kontroluje kolejność sortowania GuiObject przy użyciu UIGridStyleLayout .
Ustawia GuiObject, które zostaną wybrane, gdy selektor gamepada zostanie przesunięty w dół.
Ustawia GuiObject, które zostaną wybrane, gdy selektor gamepada zostanie przesunięty w lewo.
Ustawia GuiObject, które zostaną wybrane, gdy selektor gamepada zostanie przesunięty w prawo.
Ustawia GuiObject, które zostaną wybrane, gdy selektor gamepada zostanie przesunięty w górę.
Określa pozycję piksela i skalarną pozycję GuiObject.
Określa liczbę stopni, w jakich GuiObject jest obrócony.
Określ, czy GuiObject może być wybrane przez gamepad.
Zastępuje domyślną ozdobę selekcji używaną do gamepadów.
Kolejność GuiObjects wybrana przez wybór interfejsu gamepada.
Określa rozmiar piksela i skali GuiObject .
Ustawia osie Size, na których GuiObject będzie oparty, w stosunku do rozmiaru jego rodzica.
Mieszana właściwość BackgroundTransparency i TextTransparency.
Określa, czy GuiObject i jego potomkowie zostaną wyrenderowane.
Określa kolejność, w której renderowanie GuiObject względem innych.
Opisuje rzeczywistą pozycję ekranu elementu GuiBase2d w pikselach.
Opisuje rzeczywitą rotację ekranu elementu GuiBase2d w stopniach.
Opisuje rzeczywistą rozdzielczość ekranu elementu GuiBase2d w pikselach.
Gdy ustawiono na true, lokalizacja zostanie zastosowana do tego GuiBase2d i jego potomków.
Odwołanie do LocalizationTable , które ma być użyte do zastosowania automatyzowanej lokalizacji do tego GuiBase2d i jego potomków.
Dostosowuje zachowanie wyboru pada w dół w grze.
Dostosowuje zachowanie wyboru gamepada w lewo.
Dostosowuje zachowanie wyboru gamepada w prawnym kierunku.
Dostosowuje zachowanie wyboru gamepada w kierunku góry.
Umożliwia dostosowanie ruchu wyboru gamepada.
Metody
Metody odziedziczeni z: GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Płynnie przenosi interfejs użytkownika do nowego UDim2.
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Płynnie przesuwa interfejs użytkownika do nowego rozmiaru i pozycji.
Zdarzenia
Wystrzeliwuje, gdy przycisk jest aktywowany.
Wystrzeliwuje, gdy mysz użytkownika w pełni kliknie GuiButton .
Wystrzeliwuje, gdy użytkownik naciśnie lewy przycisk myszy w dół na GuiButton.
Wystrzeliwuje, gdy użytkownik uwalnia lewy przycisk myszy z GuiButton.
Wystrzeliwuje, gdy mysz użytkownika w pełni kliknie prawym przyciskiem na GuiButton .
Wystrzeliwuje, gdy użytkownik naciśnie prawy przycisk myszy w dół na GuiButton.
Wystrzeliwuje, gdy użytkownik uwalnia prawy przycisk myszy z GuiButton.
Wystrzeliwany, gdy użytkownik zaczyna interakcję za pomocą urządzenia interfejsu człowiek-komputer (przycisk myszy w dół, dotknięcie rozpoczęcia, przycisk klawiatury w dół itp.).
Wystrzeliwany, gdy użytkownik zmienia sposób interakcji za pomocą urządzenia interfejsu człowiek-komputer (przycisk myszy w dół, dotknięcie początku, przycisk klawiatury w dół itp.).
Wystrzeliwany, gdy użytkownik przestaje interakcjonować za pomocą urządzenia interfejsu człowiek-komputer (przycisk myszy w dół, dotknięcie początku, przycisk klawiatury w dół itp.).
Wystrzeliwuje, gdy użytkownik przesuwa mysz do elementu GUI.
Wystrzeliwuje, gdy użytkownik przesuwa mysz poza element interfejsu graficznego.
Wystrzeliwuje za każdym razem, gdy użytkownik przesuwa mysz, gdy znajduje się w środku elementu GUI.
Wystrzeliwuje, gdy użytkownik przewija koło myszy wstecz, gdy mysz znajduje się nad elementem GUI.
Wystrzeliwuje, gdy użytkownik przewija koło myszy w przód, gdy mysz znajduje się nad elementem GUI.
Wystrzeliwany, gdy GuiObject jest skupiany za pomocą wyboru Gamepad.
Wystrzelony, gdy wybór Gamepada przestaje skupiać się na GuiObject.
Wystrzeliwuje, gdy gracz zaczyna, kontynuuje i zatrzymuje długie naciśnięcie elementu interfejsu.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Wystrzeliwuje, gdy gracz przesuwa palec po elementze interfejsu.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Wystrzeliwuje, gdy gracz wykonuje gest przesuwania lub ciągnięcia za pomocą dwóch palców na element UI.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Wystrzeliwuje, gdy gracz wykonuje gest rotacji za pomocą dwóch palców na element UI.
Wypala się, gdy gracz wykonuje gest przesuwania na element interfejsu użytkownika.
Wystrzeliwuje, gdy gracz wykonuje gest dotknięcia na element interfejsu.
- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Wybucha, gdy wybór gamepada przenosi się do, opuszcza lub zmienia w ramach połączonego GuiBase2d lub dowolnego potomka GuiObjects.
Właściwości
AutoButtonColor
Właściwość ta określa, czy przycisk automatycznie zmienia kolor, gdy użytkownik przewija nad nim Mouse lub klika na niego.Jeśli true , przycisk automatycznie zmieni kolor, gdy mysz przewija się nad nim lub kliknie na niego.Jeśli false, przycisk nie zmieni się.
Jeśli chcesz dostosować, jak zmienia się przycisk, gdy mysz użytkownika przewija się nad nim lub klika na niego, rozważ użycie ImageButton i zmianę elementu HoverImage i PressedImage.
Pamiętaj, że ta właściwość nie będzie miała wpływu na ImageButton jeśli jej właściwość Image jest ustawiona na obraz.Ponadto ta właściwość nie wpłynie na ImageButton przy przewijaniu myszką, gdy jej HoverImage nie jest nil , ani na kliknięcie myszy, jeśli jej PressedImage nie jest nil .
Modal
Jeśli true podczas gdy element GUI jest widoczny, mysz nie zostanie zamknięta, chyba że prawy przycisk myszy jest w dół.
Metody
Zdarzenia
Activated
Wystrzeliwuje, gdy przycisk jest aktywowany.Ponieważ to wydarzenie nie wystrzeliwuje na serwerze, powinno być używane tylko w LocalScript lub w Script z RunContext z Enum.RunContext.Client.
Parametry
MouseButton1Click
To wydarzenie wystrzeliwuje, gdy mysz użytkownika w pełni kliknie na GuiButton.
Jeśli chodzi o klikanie, mysz musi znajdować się w granicach GuiButton i przycisk myszy musi zostać ponownie naciśnięty w dół i w górę, zanim wydarzenie się uruchomi.Jeśli mysz opuści granice GuiButton i zostanie uwolniona, wydarzenie nie zostanie uruchomione.Jeśli chcesz uniknąć tego ograniczenia, możesz użyć MouseButton1Down i MouseButton1Up ; te wydarzenia są podobne, ale będą wystrzeliwane za każdym razem, gdy użytkownik naciśnie lewy przycisk myszy w dół lub w górę, odpowiednio.
MouseButton1Down
To wydarzenie wystrzeliwuje, gdy użytkownik naciśnie lewy przycisk myszy na GuiButton.
W przypadku wydarzenia wymagającego, aby użytkownik naciśnięty i uwolnił lewą mysz na GuiButton w celu uruchomienia wydarzenia, rozważ użycie MouseButton1Click.
Parametry
MouseButton1Up
To wydarzenie wystrzeliwuje, gdy użytkownik uwalnia lewy przycisk myszy z GuiButton.
W przypadku wydarzenia wymagającego, aby użytkownik naciśnięty i uwolnił lewą mysz na GuiButton w celu uruchomienia wydarzenia, rozważ użycie MouseButton1Click.
Parametry
MouseButton2Click
To wydarzenie wystrzeliwuje, gdy mysz użytkownika w pełni kliknie prawym przyciskiem myszy na GuiButton.
Jeśli chodzi o klikanie, mysz musi znajdować się w granicach GuiButton i przycisk myszy musi zostać ponownie naciśnięty w dół i w górę, zanim wydarzenie się uruchomi.Jeśli mysz opuści granice GuiButton i zostanie uwolniona, wydarzenie nie zostanie uruchomione.Jeśli chcesz uniknąć tego ograniczenia, możesz użyć MouseButton2Down i MouseButton2Up ; te wydarzenia są podobne, ale będą wystrzeliwane za każdym razem, gdy użytkownik naciśnie prawy lub lewy przycisk myszy, odpowiednio.
MouseButton2Down
To wydarzenie wystrzeliwuje, gdy użytkownik naciśnie prawy przycisk myszy w dół na GuiButton.
W przypadku wydarzenia wymagającego, aby użytkownik naciśnięty i uwolnił prawy mysz na GuiButton w celu uruchomienia wydarzenia, rozważ użycie MouseButton2Click.
Parametry
MouseButton2Up
To wydarzenie wystrzeliwuje, gdy użytkownik uwalnia prawy przycisk myszy z GuiButton.
W przypadku wydarzenia wymagającego, aby użytkownik naciśnięty i uwolnił prawy mysz na GuiButton w celu uruchomienia wydarzenia, rozważ użycie MouseButton2Click.