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 abstraktną klasą, która odziedziczała się z GuiObject. Jest to podstawowa klasa dla ImageButton i
Najważniejszym wydarzeniem w GuiButton jest GuiButton.Activated, multi-platformowe wydarzenie, które się uruchamia, gdy przycisk jest aktywowany. Gdy używasz myszy, oznacza to klikni
Podsumowanie
Właściwości
Określa, czy przycisk automatycznie zmienia kolor, gdy myszka jest na nim lub klikać na niego.
Jeśli jest prawy, a element GUI jest widoczny, myszka nie zostanie zablokowana, chyba że prawe przyciski myszy są naciśnięte.
Booleanowa wartość, która wskazuje, czy obiekt został wybrany.
Zdefiniowuje styl GuiButton na podstawie listy uprzednio zdefiniowanych stylów.
Określa, czy ten element interfejsu wchłania wejście.
Określa punkt pochodzenia GuiObject względem jego wielkości absolutnej.
Określa, czy zmiana rozmiaru następuje w oparciu o treści dziecka.
Określa kolor tła GuiObject .
Określa przejrzystość tła GuiObject i ramy.
Określa kolor GuiObject granicy.
Określa sposób, w jaki GuiObject granica jest rozdzielana w stosunku do jej wymiarów.
Określa szerokość piksela GuiObject granicy.
Określa, czy potomstwo GuiObjects poza granicami elementu GUI rodzica powinno się renderować.
Określa, czy mikser gracza jest aktywnie naciskany na GuiObject lub nie.
Określa, czy GuiButton może być zainterakcjonowany z lub nie, lub czy GuiState z GuiObject zmienia się lub nie.
Kontroluje kolejność sortowania GuiObject z użyciem UIGridStyleLayout.
Ustawia GuiObject, który zostanie wybrany, gdy selektor gamepad zostanie przesunięty w dół.
Ustawia GuiObject, który zostanie wybrany, gdy selektor gamepad'a zostanie przeniesiony do lewej.
Ustawia GuiObject, który zostanie wybrany, gdy selektor gamepad'a zostanie przesunięty do prawej.
Ustawia GuiObject, który zostanie wybrany, gdy selektor gamepad'a zostanie przesunięty w górę.
Określa pozycję piksela i skalary GuiObject .
Określa liczbę stopni, w których obrócony jest GuiObject.
Określ, czy GUI może być wybrany przez gamepad.
Przywraca używany na płytach gier standardowy wzór wyboru.
Sortowanie GuiObjects wybrane przez interfejs wyboru gamepad'a.
Określa rozmiar piksela i skalary Class.GuiObject .
Ustawia Size osi, na których będzie opierać się GuiObject w odniesieniu do rozmiarów jego ojca.
Mieszana własność BackgroundTransparency i TextTransparency .
Określa, czy GuiObject i jego potomstwo zostaną renderowane.
Określa porządek, w jakim GuiObject renderuje w stosunku do innych.
Opisuje rzeczywistą pozycję ekranu elementu UI, w pikselach.
Opisuje rzeczywistą rotację ekranu elementu UI, w stopniach.
Opisuje rzeczywisty rozmiar ekranu elementu UI, w pikselach.
Ustawione na prawdę, lokalizacja zostanie zastosowana do tego GuiBase2d i jego potomnych.
Odnośnik do LocalizationTable używany do zastosowania automatycznej lokalizacji do tego GuiBase2d i jego potomnych.
Dostosowuje zachowanie wyboru gry w dół.
Dostosuj zachowanie selekcji sterowania w lewym kierunku.
Dostosuj zachowanie selekcji gry w odpowiednim kierunku.
Dostosowuje zachowanie wyboru gry w górę.
Umożliwia dostosowanie ruchu wyboru gry.
Metody
Metody odziedziczeni z: GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Płynnie przesuwa GUI do nowego UDim2 .
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Płynnie skala GUI do nowego UDim2 .
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Smoothly przesuwa GUI do nowego rozmiaru i pozycji.
Zdarzenia
Wystrzeliwany jest po aktywowaniu przycisku.
Wystrzelony, gdy myszka całkowicie opuściła kliknięty przycisk GUI.
Wystrzelony, gdy myszka jest w stanie lewego kliczenia w dół na obiekcie GUI.
Wystrzelony, gdy lewy mouse uwolnił obiekt GUI.
Wystrzelony, gdy myszka w pełni kliknięta przycisk GUI.
Wystrzelony, gdy myszka jest w stanie prawy w dół na obiekcie GUI.
Wystrzelony, gdy przycisk myszy prawy zostanie uwolniony na obiekcie GUI.
Wystrzelony, gdy użytkownik zacznie interagować za pośrednictwem urządzenia interfejsu człowiek-komputer (przycisk myszy, dotknięcie początku, klawiatura do klawiatury, itp).
Wystrzelony, gdy użytkownik zmienia sposób interakcji za pośrednictwem urządzenia interfejsu człowiek-komputer (przycisk myszy, dotknięcie początku, klawiatura do klawiatury, itp).
Wystąpił problem, gdy użytkownik przestał interagować za pośrednictwem urządzenia interfejsu człowiek-komputer (przycisk myszy, dotknięcie początku, klawiatura, itp).
Wystrzela, gdy użytkownik przesuwa myszkę do elementu GUI.
Wystrzela, gdy użytkownik porusza myszką poza elementem GUI.
Wystrzela, gdy użytkownik porusza myszką, gdy jest w środku elementu GUI.
Wystrzela, gdy użytkownik przesuwa myszką z powrotem, gdy myszka jest nad elementem GUI.
Wystrzela, gdy użytkownik przesuwa myszką do przodu, gdy myszka jest nad elementem GUI.
Wystrzelony, gdy GuiObject jest skupiony na z wyborem Gamepad.
Wystrzelony, gdy selektor Gamepad przestał skupiać się na GuiObject.
Wystąpi, gdy gracz rozpocznie, będzie kontynuował i zatrzyma długo naciskał element UI.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Wystrzela, gdy gracz porusza palcem po obszarze UI.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Wystrzela, gdy gracz wykonuje ruch pociągnięcia lub pociągnięcia za pomocą dwóch palców na elementze UI.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Wystąpi, gdy gracz wykonuje rotacyjny gest używając dwóch palców na elementze UI.
Wystąpi, gdy gracz wykonuje gest swipe'u na element UI.
Wystąpi, gdy gracz wykonuje gest tap na element UI.
- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Występuje, gdy selekcja gamepad'a przesuwa się do, wychodzi lub zmienia w ciągu połączonego GuiBase2d lub dowolnego potomnego GuiObjects.
Właściwości
AutoButtonColor
Automatyczny kolor przycisku określa, czy przycisk automatycznie zmienia kolor, gdy Mouse użytkownika pojawia się nad nim lub klika na niego.
Jeśli jest to prawdą, przycisk automatycznie zmieni kolor, gdy myszka po nim się pojawi lub kliknie. Jeśli to nie jest prawdą, przycisk nie zostanie zmieniony.
Jeśli chcesz dostosować sposób, w jaki zmienia się przycisk, gdy myszka użytkownika pojawia się nad nim lub klika na niego, rozważaj użycie ImageButton GUI i zmianę elementu ImageButton.HoverImage i ImageButton.PressedImage.
Uwaga: Ta właściwość nie będzie miała wpływu na ImageButton jeśli jego właściwość ustawiona jest na ImageButton.Image obrazu i nie jest on nulowy. Dodatkowo właściwość ta nie będzie miała wpływu na element ImageButton.HoverImage na myszce, je
Przykłady kodu
local button = script.Parent
if button:IsA("ImageButton") then
if button.HoverImage and button.ClickImage then
return
end
end
button.AutoButtonColor = true
Modal
Jeśli jest prawy, a element GUI jest widoczny, myszka nie zostanie zablokowana, chyba że prawe przyciski myszy są naciśnięte.
Style
Zdefiniowuje styl GuiButton na podstawie listy uprzednio zdefiniowanych stylów.
Metody
Zdarzenia
Activated
Występuje, gdy przycisk jest aktywowany. W tym wydarzeniu nie jest ono uruchamiane na serwerze, powinno być używane tylko w LocalScript lub w Script z RunContext z 1> Ennum.RunContext.Client1> .
Parametry
MouseButton1Click
Wydarzenie MouseButton1Click zachodzi, gdy użytkowniku Mouse całkowicie opuścił kliknięcia przycisku GUI.
Klikając, myszka musi być w granicach przycisku i musi być ponownie nacisnąta w dół i w górę, zanim ten wątek się wykonuje. Jeśli myszka opuści granice przycisku i zostanie uwolniona, wydarzenie nie zostanie wykonane. Jeśli chcesz uniknąć tego ograniczenia, możesz użyć Class.Gui
Ten ewent jest podobny do GuiButton.MouseButton2Click, który zachowuje się identycznie, z wyjątkiem tego, że jest połączony z prawym przyciskiem myszy użytkownika.
Uwaga, że ten wątek zostanie wykonany tylko dla przycisków GUI, w tym TextButtons i ImageButton. Nie zostanie wykonany dla innych GuiObjects.
Przykłady kodu
local button = script.Parent
local function leftClick()
print("Left mouse click")
end
local function rightClick()
print("Right mouse click")
end
button.MouseButton1Click:Connect(leftClick)
button.MouseButton2Click:Connect(rightClick)
MouseButton1Down
Wydarzenie MouseButton1Down pojawia się, gdy użytkownik nacisnął swoją lewą przyciskiem Mouse na obiekcie GUI.
Ten wydarzenie jest podobny do GuiButton.MouseButton2Down, który zachowuje się identycznie, z wyjątkiem tego, że jest połączony z prawym przyciskiem myszy użytkownika.
Jeśli szukasz wydarzenia wymagającego użytkownika nacisnąć i uwolnić lewy przycisk myszy na GUI, aby wydarzenie się uruchomić, rozważ GuiButton.MouseButton1Click .
Uwaga, że ten wątek zostanie wykonany tylko dla przycisków GUI, w tym TextButtons i ImageButton. Nie zostanie wykonany dla innych GuiObjects.
Parametry
Przykłady kodu
local button = script.Parent
local function leftMouseButtonUp(x, y)
print("Left mouse up at", x, y)
end
local function leftMouseButtonDown(x, y)
print("Left mouse down at", x, y)
end
button.MouseButton1Up:Connect(leftMouseButtonUp)
button.MouseButton1Down:Connect(leftMouseButtonDown)
MouseButton1Up
Wydarzenie MouseButton1Up występuje, gdy użytkownik uwalnia swoją lewą Mouse poza obiektem GUI.
Ten wydarzenie jest podobny do GuiButton.MouseButton2Up, który zachowuje się identycznie, z wyjątkiem tego, że jest połączony z prawym przyciskiem myszy użytkownika.
Jeśli szukasz wydarzenia wymagającego użytkownika nacisnąć i uwolnić lewy przycisk myszy na GUI, aby wydarzenie się uruchomić, rozważ GuiButton.MouseButton1Click .
Uwaga, że ten wątek zostanie wykonany tylko dla przycisków GUI, w tym TextButtons i ImageButton. Nie zostanie wykonany dla innych GuiObjects.
Parametry
Przykłady kodu
local button = script.Parent
local function leftMouseButtonUp(x, y)
print("Left mouse up at", x, y)
end
local function leftMouseButtonDown(x, y)
print("Left mouse down at", x, y)
end
button.MouseButton1Up:Connect(leftMouseButtonUp)
button.MouseButton1Down:Connect(leftMouseButtonDown)
MouseButton2Click
Wydarzenie MouseButton2Click występuje, gdy użytkownik w pełni prawy kliknięty przycisk GUI.
Klikając, myszka musi być w granicach przycisku i musi być ponownie nacisnąta w dół i w górę, zanim ten wątek się wykonuje. Jeśli myszka opuści granice przycisku i zostanie uwolniona, wydarzenie nie zostanie wykonane. Jeśli chcesz uniknąć tego ograniczenia, możesz użyć Class.Gui
Ten wydarzenie jest podobny do GuiButton.MouseButton1Click, który zachowuje się identycznie, z wyjątkiem tego, że jest połączony z lewym przyciskiem myszy użytkownika.
Uwaga, że ten wątek zostanie wykonany tylko dla przycisków GUI, w tym TextButtons i ImageButton. Nie zostanie wykonany dla innych GuiObjects.
Przykłady kodu
local button = script.Parent.Button
local function rightClick()
print("Right click pressed down and up on button.")
end
button.MouseButton2Click:Connect(rightClick)
MouseButton2Down
Wydarzenie MouseButton2Down wyzwane, gdy użytkownik naciśnie swoje prawe przyciski Mouse na obiekcie GUI.
Ten ewent jest podobny do GuiButton.MouseButton1Down, który zachowuje się identycznie, z wyjątkiem tego, że jest połączony z lewym przyciskiem myszy użytkownika.
Jeśli szukasz wydarzenia wymagającego użytkownika nacisnąć i uwolnić myszkę na GUI, aby wydarzenie zostało uruchomione, rozważ GuiButton.MouseButton2Click.
Uwaga, że ten wątek zostanie wykonany tylko dla przycisków GUI, w tym TextButtons i ImageButton. Nie zostanie wykonany dla innych GuiObjects.
Parametry
Przykłady kodu
local gui = script.Parent
local button = gui.Button
function rightMouseButtonUp(x, y)
print("Right mouse up", x, y)
end
function rightMouseButtonDown(x, y)
print("Right mouse down", x, y)
end
button.MouseButton2Up:Connect(rightMouseButtonUp)
button.MouseButton2Down:Connect(rightMouseButtonDown)
MouseButton2Up
Wydarzenie MouseButton2Up występuje, gdy użytkownik uwalnia swoje prawe Mouse poza obiektem GUI.
Ten wydarzenie jest podobny do GuiButton.MouseButton1Up, który zachowuje się identycznie, z wyjątkiem tego, że jest połączony z lewym przyciskiem myszy użytkownika.
Jeśli szukasz wydarzenia wymagającego użytkownika nacisnąć i uwolnić myszkę na GUI, aby wydarzenie zostało uruchomione, rozważ GuiButton.MouseButton2Click.
Uwaga, że ten wątek zostanie wykonany tylko dla przycisków GUI, w tym TextButtons i ImageButton. Nie zostanie wykonany dla innych GuiObjects.
Parametry
Przykłady kodu
local gui = script.Parent
local button = gui.Button
function rightMouseButtonUp(x, y)
print("Right mouse up", x, y)
end
function rightMouseButtonDown(x, y)
print("Right mouse down", x, y)
end
button.MouseButton2Up:Connect(rightMouseButtonUp)
button.MouseButton2Down:Connect(rightMouseButtonDown)