GuiButton
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
GuiButton es una clase abstracta que hereda de GuiObject . Es la clase base para ImageButton y Class.TextButton
El evento más importante de un GuiButton es GuiButton.Activated, un evento 多平台 que se activa cuando el botón se activa. Cuando se usa un ratón, esto significa hacer clic en el botón y soltar con el cursor tod
Resumen
Propiedades
Determina si el botón cambia de color automáticamente cuando el mouse se posiciona sobre él o hace clic en él.
Si es cierto mientras el elemento GUI es visible, el mouse no se bloqueará a menos que el botón derecho del ratón esté abajo.
Propiedad deBooleano que indica si el objeto ha sido seleccionado.
Establece el estilo del GuiButton según una lista de estilos predeterminados.
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.
Describe la posición de pantalla actual de un elemento de UI, en píxeles.
Describe la rotación de pantalla actual de un elemento de UI, en grados.
Describe el tamaño de pantalla actual de un elemento de UI, en píxeles.
Cuando esté configurado como verdadero, la localización se aplicará a este GuiBase2d y sus descendientes.
Una referencia a un LocalizationTable para ser usado para aplicar la localización automatizada a este GuiBase2d y sus descendientes.
Personaliza el comportamiento de la selección del gamepad en la dirección de abajo.
Personaliza el comportamiento de la selección del gamepad en la dirección de la izquierda.
Personaliza el comportamiento de la selección del gamepad en la dirección correcta.
Personaliza el comportamiento de la selección del gamepad en la dirección de arriba.
Permite la personalización del movimiento de la plataforma de juego.
Métodos
Métodos heredados 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 cuando se activa el botón.
Se ha disparado cuando el mouse ha dejado completamente clicado el botón GUI.
Se activa cuando el mouse está en el estado de abajo del mouse izquierdo en el objeto GUI.
Se ha disparado cuando el mouse izquierdo ha liberado el objeto GUI.
Se ha disparado cuando el mouse ha hecho clic con el botón derecho en el botón de GUI.
Se activa cuando el mouse está en el estado correcto de abajo del ratón en el objeto GUI.
Se ha disparado cuando el botón derecho del ratón se ha liberado en un 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
Se activa cuando la selección del gamepad se mueve, se va o cambia dentro de la GuiBase2d conectada o cualquier descendiente de GuiObjetos.
Propiedades
AutoButtonColor
El AutoButtonColor determina si el botón cambia de color automáticamente cuando el usuario pasa el cursor sobre él o lo hace clic.
Si es así, el botón cambiará automáticamente de color cuando el mouse se posicione sobre él o hace clic en él. Si es falso, el botón no cambiará.
Si desea personalizar cómo cambia un botón cuando el mouse del usuario pasa por encima o hace clic en él, considere usar un GUI de ImageButton y cambiar el elemento de ImageButton.HoverImage y ImageButton.PressedImage .
Tenga en cuenta que esta propiedad no tendrá un efecto en un ImageButton si se establece que es propiedad de ImageButton.Image y no es nulo. Además, la propiedad no afectará a un elemento de ImageButton en el estado de mover el mouse cuando su propiedad ImageButton.HoverImage
Muestras de código
local button = script.Parent
if button:IsA("ImageButton") then
if button.HoverImage and button.ClickImage then
return
end
end
button.AutoButtonColor = trueModal
Si es cierto mientras el elemento GUI es visible, el mouse no se bloqueará a menos que el botón derecho del ratón esté abajo.
Métodos
Eventos
Activated
Se activa cuando se activa el botón. Como este evento no se activa en el servidor, solo se debe usar en un LocalScript o en un Script con RunContext de 2> Enums.RunContext.Client2> .
Parámetros
MouseButton1Click
El evento MouseButton1Click se activa cuando el usuario deja completamente los clics del botón GUI.
Al hacer clic, el mouse tiene que estar en los límites del botón y tiene que ser presionado hacia abajo y hacia arriba de nuevo antes de que este evento se disparara. Si el mouse sale de los límites del botón y se libera, el evento no se desencadenar. Si desea evitar esta limitación, puede usar GuiButton.MouseButton1Down y MouseButton1Up . Estos
Este evento es similar a GuiButton.MouseButton2Click, que se comporta idénticamente excepto que está conectado al botón derecho del ratón del usuario.
Tenga en cuenta que este evento solo se activará para los botones de GUI, incluido TextButtons y ImageButton . No se activará para otros GuiObjects .
Muestras de código
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
El evento MouseButton1Down se activa cuando el usuario presiona su botón izquierdo Class.Mouse en el objeto GUI.
Este evento es similar a GuiButton.MouseButton2Down , que se comporta idénticamente excepto que está conectado al botón derecho del ratón del usuario.
Si está buscando un evento que requiere que el usuario presione y suelte su mouse izquierdo en un GUI para que se desencadenarel evento, considere usar GuiButton.MouseButton1Click .
Tenga en cuenta que este evento solo se activará para los botones de GUI, incluido TextButtons y ImageButton . No se activará para otros GuiObjects .
Parámetros
La coordenada x de la pantalla del ratónen píxeles.
La coordenada de la pantalla del ratónen píxeles.
Muestras de código
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
El evento MouseButton1Up se activa cuando el usuario suelta su izquierda Mouse fuera del objeto GUI.
Este evento es similar a GuiButton.MouseButton2Up, que se comporta idénticamente excepto que está conectado al botón derecho del usuario.
Si está buscando un evento que requiere que el usuario presione y suelte su mouse izquierdo en un GUI para que se desencadenarel evento, considere usar GuiButton.MouseButton1Click .
Tenga en cuenta que este evento solo se activará para los botones de GUI, incluido TextButtons y ImageButton . No se activará para otros GuiObjects .
Parámetros
La coordenada x de la pantalla del ratónen píxeles.
La coordenada de la pantalla del ratónen píxeles.
Muestras de código
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
El evento MouseButton2Click se activa cuando el usuario hace clic en el botón de GUI completamente derecho.
Al hacer clic, el mouse tiene que estar en los límites del botón y tiene que ser presionado hacia abajo y hacia arriba de nuevo antes de que este evento se disparara. Si el mouse sale de los límites del botón y se libera, el evento no se desencadenar. Si desea evitar esta limitación, puede usar GuiButton.MouseButton2Down y MouseButton2Up . Estos
Este evento es similar a GuiButton.MouseButton1Click, que se comporta idénticamente excepto que está conectado al botón izquierdo del ratón del usuario.
Tenga en cuenta que este evento solo se activará para los botones de GUI, incluido TextButtons y ImageButton . No se activará para otros GuiObjects .
Muestras de código
local button = script.Parent.Button
local function rightClick()
print("Right click pressed down and up on button.")
end
button.MouseButton2Click:Connect(rightClick)
MouseButton2Down
El evento MouseButton2Down se activa cuando el usuario presiona su botón derecho Mouse en el objeto GUI.
Este evento es similar a GuiButton.MouseButton1Down , que se comporta idénticamente excepto que está conectado al botón izquierdo del ratón del usuario.
Si está buscando un evento que requiere que el usuario presione y suelte su botón derecho en un GUI para que se desencadenarel evento, considere usar GuiButton.MouseButton2Click .
Tenga en cuenta que este evento solo se activará para los botones de GUI, incluido TextButtons y ImageButton . No se activará para otros GuiObjects .
Parámetros
La coordenada x de la pantalla del ratónen píxeles.
La coordenada de la pantalla del ratónen píxeles.
Muestras de código
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
El evento MouseButton2Up se activa cuando el usuario suelta su derecha Mouse fuera del objeto GUI.
Este evento es similar a GuiButton.MouseButton1Up , que se comporta idénticamente excepto que está conectado al botón izquierdo del ratón del usuario.
Si está buscando un evento que requiere que el usuario presione y suelte su botón derecho en un GUI para que se desencadenarel evento, considere usar GuiButton.MouseButton2Click .
Tenga en cuenta que este evento solo se activará para los botones de GUI, incluido TextButtons y ImageButton . No se activará para otros GuiObjects .
Parámetros
La coordenada x de la pantalla del ratónen píxeles.
La coordenada de la pantalla del ratónen píxeles.
Muestras de código
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)