GuiButton
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
O GuiButton é uma classe abstrata que herda de GuiObject . É a classe base para ImageButton e Class.Text
O evento mais importante de um GuiButton é GuiButton.Activated, um evento multi-plataforma que dispara quando o botão é ativado. Quando usando um mouse, isso significa clicar no botão e soltar com o cursor
Resumo
Propriedades
Determina se o botão muda de cor automaticamente quando o mouse passa por cima ou clica nele.
Se verdadeiro, enquanto o elemento GUI estiver visível, o mouse não será bloqueado a menos que o botão direito do mouse esteja abaixo.
Uma propriedade boolean que indica se o objeto foi selecionado.
Define o estilo do GuiButton com base em uma lista de estilos pré-definidos.
Determina si este elemento de la interfaz de usuario acepta la entrada.
Determina el punto de origen de un GuiObject , relativo a su tamaño absoluto.
Determina si se produce el escalado en función del contenido de los hijos.
Determina el color de fondo de GuiObject
Determina la transparencia de la capa de fondo y el borde de GuiObject
Determina el color de la frontera de GuiObject .
Determina de qué manera se coloca el límite de GuiObject en relación con sus dimensiones.
Determina el ancho de píxel de la frontera GuiObject .
Determina si el descendiente GuiObjects fuera de los límites de un elemento GUI padre debe Renderizar.
Determina si el mouse del jugador está siendo presionado activamente en el GuiObject o no.
Determina si el GuiButton se puede interactuar con o no, o si el GuiState del GuiObject está cambiando o no.
Controla el orden de clasificación del GuiObject cuando se usa con un UIGridStyleLayout .
Establece el GuiObject que se seleccionará cuando el seleccionador de plataforma de juego se mueva hacia abajo.
Establece el GuiObject que se seleccionará cuando el seleccionador de plataforma se mueva a la izquierda.
Establece el GuiObject que se seleccionará cuando el seleccionador de plataforma de juegos se mueva a la derecha.
Establece el GuiObject que se seleccionará cuando el seleccionador de plataforma de juego se mueva hacia arriba.
Determina la posición de píxeles y escalares de GuiObject .
Determina el número de grados en los que se gira el GuiObject .
Determine si el GUI puede ser seleccionado por un controlador para juego.
Sobrecarga el adorno de selección predeterminado utilizado para las plataformas de juegos.
El orden de GuiObjects seleccionado por la interfaz de usuario del gamepad.
Determina el tamaño de píxeles y escalares del GuiObject .
Establece los ejes Size en los que se basará el GuiObject relativos al tamaño de su padre.
Una propiedad mixta de BackgroundTransparency y TextTransparency .
Determina si el GuiObject y sus descendientes serán renderizados.
Determina el orden en que se renderiza un GuiObject en relación con los demás.
Descreve a posição real da tela de um elemento da interface, em pixels.
Descreve a rotação de tela real de um elemento da interface, em graus.
Descreve o tamanho real da tela de um elemento da interface, em pixels.
Quando definido como verdadeiro, a localização será aplicada a este GuiBase2d e aos seus descendentes.
Uma referência a um LocalizationTable para ser usado para aplicar localização automatizada a este GuiBase2d e seus descendentes.
Personaliza o comportamento de seleção do gamepad na direção de baixo.
Personaliza o comportamento de seleção do gamepad na direção esquerda.
Personaliza o comportamento de seleção do gamepad na direção certa.
Personaliza o comportamento de seleção do gamepad na direção de cima.
Permite personalizar o movimento da almofada de jogo.
Métodos
Métodos herdados de GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Mueve con suavidad un GUI a un nuevo UDim2 .
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Escala con suavidad un GUI a un nuevo UDim2 .
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Mueve con suavidad una GUI a un nuevo tamaño y posición.
Eventos
Dispara quando o botão é ativado.
Iniciado quando o mouse estiver totalmente clicado no botão GUI.
Ativado quando o mouse está no estado mínimo esquerdo do mouse na ObjetoGUI.
Iniciado quando o mouse esquerdo liberou o ObjetoGUI.
Iniciado quando o mouse clicou duas vezes no botão GUI.
Ativado quando o mouse está no estado correto do mouse para baixo na ObjetoGUI.
Iniciado quando o botão direito do mouse foi liberado em um Objeto GUI.
Se ha disparado cuando un usuario comienza a interactuar a través de un dispositivo de interfaz humana-ordenador (botón de ratón, toque para comenzar, botón de teclado, etc).
Se activa cuando un usuario cambia cómo interactúa a través de un dispositivo de interfaz humana-ordenador (botón de ratón, toque para comenzar, botón de teclado, etc).
Se ha disparado cuando un usuario deja de interactuar a través de un dispositivo de interfaz humana-ordenador (botón de ratón, toque para empezar, botón de teclado, etc).
Dispara cuando un usuario mueve su mouse hacia un elemento GUI.
Se activa cuando un usuario mueve el mouse fuera de un elemento de la GUI.
Dispara cuando un usuario mueve el mouse mientras está dentro de un elemento GUI.
Dispara cuando un usuario desplaza su rueda de ratón cuando el ratón está sobre un elemento de GUI.
Se activa cuando un usuario desplaza su rueda de ratón hacia delante cuando el ratón está sobre un elemento de GUI.
Se activa cuando el GuiObject está siendo enfocado con el GamepadSelector.
Se activa cuando el GamepadSelector deja de enfocarse en el GuiObject.
Se activa cuando el jugador comienza, continúa y termina presionando el elemento de la interfaz de usuario.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Dispara cuando el jugador mueve su dedo en el elemento de la interfaz de usuario.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Dispara cuando el jugador realiza un gesto de pinchazo o de tiro usando dos dedos en el elemento de la interfaz de usuario.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Dispara cuando el jugador realiza un gesto de rotación usando dos dedos en el elemento de la interfaz de usuario.
Se activa cuando el jugador realiza un gesto de desplazamiento en el elemento de la interfaz de usuario.
Se activa cuando el jugador realiza un gesto de toque en el elemento de la interfaz de usuario.
- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Ativado quando a seleção do gamepad se move para, sai ou muda dentro da GuiBase2d conectada ou de qualquer descendente GuiObjects.
Propriedades
AutoButtonColor
O AutoButtonColor determina se o botão será automaticamente alterado de cor quando o usuário estiver segurando Mouse sobre ou clicando nele.
Se for verdade, o botão será automaticamente alterado quando o mouse passar por cima ou clicar nele. Se for falso, o botão não será alterado.
Se você gostaria de personalizar como um botão muda quando o mouse do usuário passa por cima ou clica nele, considere usar uma ImageButton GUI e alterar o elemento ImageButton.HoverImage e Class.ImageButton.PressedImage 2> .
Por favor, note que esta propriedade não terá um efeito em um ImageButton se sua propriedade for definida como uma imagem e não for null. Além disso, a propriedade não afetará um elemento ImageButton no mouse hover quando sua propriedade for definida como uma imagem e não for null ou no mouse click if 4> Class.ImageButton.PressedImage
Amostras de código
The code below enables a button's GuiButton.AutoButtonColor as long as it it not a ImageButton with ImageButton.HoverImage and ImageButton.PressedImage properties set to images.
In order for the code to work as expected, it must be placed in a LocalScript that is a child of the button.
local button = script.Parent
if button:IsA("ImageButton") then
if button.HoverImage and button.ClickImage then
return
end
end
button.AutoButtonColor = trueModal
Se verdadeiro, enquanto o elemento GUI estiver visível, o mouse não será bloqueado a menos que o botão direito do mouse esteja abaixo.
Métodos
Eventos
Activated
Solte quando o botão for ativado. Como este evento não é disparado no servidor, ele deve ser usado apenas em um LocalScript ou em um Script com RunContext de 2>Class.Script2> .
Parâmetros
MouseButton1Click
O evento MouseButton1Click ocorre quando o usuário deixa completamente os cliques Mouse para cliques GUI.
Ao clicar, o mouse tem que estar nos limites do botão e tem que ser pressionado para baixo e para cima novamente antes que esse evento atire. Se o mouse sair dos limites do botão e for liberado, o evento não Iniciar / executar. Se você quiser evitar essa limitação, você pode usar GuiButton.MouseButton1Down e MouseButton1Up. Ess
Este evento é semelhante a GuiButton.MouseButton2Click, que se comporta idêntico, exceto que está conectado ao botão direito do mouse do usuário.
Nota que este evento só será executado para botões GUI, incluindo TextButtons e ImageButton. Não será executado para outros GuiObjects.
Amostras de código
The code sample below demonstrates how to use the GuiButton.MouseButton1Click and GuiButton.MouseButton2Click events to handle user left and right mouse button input on a GuiButton.
For the example to work expected, the LocalScript containing the code should be a child of the GUI button.
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
O evento MouseButton1Down ocorre quando o usuário pressiona seu botão esquerdo Class.Mouse no ObjetoGUI.
Este evento é semelhante a GuiButton.MouseButton2Down, que se comporta idêntico, exceto que está conectado ao botão direito do usuário.
Se você estiver procurando um evento que exija que o usuário pressione e solte seu mouse esquerdo em uma GUI para que o evento seja Iniciar / executar, considere usar GuiButton.MouseButton1Click.
Nota que este evento só será executado para botões GUI, incluindo TextButtons e ImageButton. Não será executado para outros GuiObjects.
Parâmetros
Amostras de código
The code sample below demonstrates how to use the GuiButton.MouseButton1Up and GuiButton.MouseButton1Down events to handle user input when the left mouse button is pressed down and released up on a GuiButton.
For the example to work expected, the LocalScript containing the code should be a child of the GUI button.
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
O evento MouseButton1Up ocorre quando o usuário solta seu botão esquerdo Mouse fora do ObjetoGUI.
Este evento é semelhante a GuiButton.MouseButton2Up, que se comporta idêntico, exceto que está conectado ao botão direito do usuário.
Se você estiver procurando um evento que exija que o usuário pressione e solte seu mouse esquerdo em uma GUI para que o evento seja Iniciar / executar, considere usar GuiButton.MouseButton1Click.
Nota que este evento só será executado para botões GUI, incluindo TextButtons e ImageButton. Não será executado para outros GuiObjects.
Parâmetros
Amostras de código
The code sample below demonstrates how to use the GuiButton.MouseButton1Up and GuiButton.MouseButton1Down events to handle user input when the left mouse button is pressed down and released up on a GuiButton.
For the example to work expected, the LocalScript containing the code should be a child of the GUI button.
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
O evento MouseButton2Click ocorre quando o usuário clica com o botão direito em qualquer botão da GUI.
Ao clicar, o mouse tem que estar nos limites do botão e tem que ser pressionado para baixo e para cima novamente antes que esse evento atire. Se o mouse sair dos limites do botão e for liberado, o evento não Iniciar / executar. Se você quiser evitar essa limitação, você pode usar GuiButton.MouseButton2Down e MouseButton2Up. Ess
Este evento é semelhante a GuiButton.MouseButton1Click, que se comporta idêntico, exceto que está conectado ao botão esquerdo do mouse do usuário.
Nota que este evento só será executado para botões GUI, incluindo TextButtons e ImageButton. Não será executado para outros GuiObjects.
Amostras de código
Demonstrates how to use the GuiButton.MouseButton2Click event to detect when a user right clicks a GuiButton.
The mouse has to be in bounds of the button and has to be pressed down and up again before this event fires.
Note: place the "RightClickScreenGui" within StarterGui for this sample to work properly.
local button = script.Parent.Button
local function rightClick()
print("Right click pressed down and up on button.")
end
button.MouseButton2Click:Connect(rightClick)
MouseButton2Down
O evento MouseButton2Down ocorre quando o usuário pressiona seu botão direito Mouse no ObjetoGUI.
Este evento é semelhante a GuiButton.MouseButton1Down, que se comporta idêntico, exceto que está conectado ao botão esquerdo do mouse do usuário.
Se você estiver procurando um evento que exija que o usuário pressione e solte seu botão direito em um GUI para que o evento seja Iniciar / executar, considere usar GuiButton.MouseButton2Click.
Nota que este evento só será executado para botões GUI, incluindo TextButtons e ImageButton. Não será executado para outros GuiObjects.
Parâmetros
Amostras de código
The code sample below demonstrates how to use the GuiButton.MouseButton2Up and GuiButton.MouseButton2Down events to handle user input when the right mouse button is pressed down and released up on a GuiButton.
For the example to work expected, the LocalScript containing the code should be a child of the GUI button.
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
O evento MouseButton2Up ocorre quando o usuário solta seu direito Mouse fora do ObjetoGUI.
Este evento é semelhante a GuiButton.MouseButton1Up, que se comporta idêntico, exceto que está conectado ao botão esquerdo do mouse do usuário.
Se você estiver procurando um evento que exija que o usuário pressione e solte seu botão direito em um GUI para que o evento seja Iniciar / executar, considere usar GuiButton.MouseButton2Click.
Nota que este evento só será executado para botões GUI, incluindo TextButtons e ImageButton. Não será executado para outros GuiObjects.
Parâmetros
Amostras de código
The code sample below demonstrates how to use the GuiButton.MouseButton2Up and GuiButton.MouseButton2Down events to handle user input when the right mouse button is pressed down and released up on a GuiButton.
For the example to work expected, the LocalScript containing the code should be a child of the GUI button.
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)