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 los objetos interactivos, clickables ImageButton y TextButton .Esta clase también define varias propiedades para el comportamiento interactivo, a saber AutoButtonColor y Modal .
El evento más importante de un GuiButton es Activated , un evento multijugador que se activa cuando se activa el botón.Al usar un ratón, esto significa hacer clic en el botón y liberar con el cursor aún sobre el objeto de la interfaz de usuario.Para el toque, se aplica lo mismo pero con un toque en lugar de pulsarun botón.Por último, para las consolas, Activated dispara si se selecciona un GuiButton cuando se presiona y se suelta el botón A .En resumen, este evento es muy útil para la programación de interfaces de usuario mult平台 ya que proporciona una interfaz general agradable para una sola entrada de usuario.
Resumen
Propiedades
Determina si el botón cambia automáticamente de color cuando el mouse se desplaza sobre él o lo hace clic.
Una instancia HapticEffect que se reproducirá cuando se esté pasando por encima del GuiButton .
Si true mientras el elemento de la interfaz de usuario es visible, el ratón no se bloqueará a menos que el botón derecho del ratón esté hacia abajo.
Una instancia HapticEffect que se reproducirá cuando se presione el GuiButton.
Una propiedad binaria que indica si el objeto ha sido seleccionado.
Establece el estilo del GuiButton basado en una lista de estilos predeterminados.
Determina si este elemento de interfaz de usuario sienta la entrada.
Determina el punto de origen de un GuiObject , relativo a su tamaño absoluto.
Determina si se produce un redimensionamiento basado en el contenido de los hijos.
Determina el color de fondo GuiObject.
Determina la transparencia del fondo y del borde GuiObject.
Determina el color del borde GuiObject .
Determina de qué manera se coloca el borde GuiObject relativo a sus dimensiones.
Determina el ancho de píxel del borde 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á presionado activamente en el GuiObject o no.
Determina si el GuiButton se puede interactuar 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 selector de gamepad se mueva hacia abajo.
Establece el GuiObject que se seleccionará cuando el seleccionador de gamepad se mueva a la izquierda.
Establece el GuiObject que se seleccionará cuando el seleccionador de gamepad se mueva a la derecha.
Establece el GuiObject que se seleccionará cuando el seleccionador de gamepad se mueva hacia arriba.
Determina la posición píxel y escalar del GuiObject .
Determina el número de grados por los cuales se gira el GuiObject .
Determine si el GuiObject se puede seleccionar por un controlador para juego.
Anula el adorno de selección predeterminado utilizado para los gamepads.
El orden de GuiObjects seleccionado por la selección de la interfaz de usuario del gamepad.
Determina el tamaño píxel y escalar del GuiObject .
Establece los ejes Size que el GuiObject se basará, en relación con el tamaño de su padre.
Una propiedad mixta de BackgroundTransparency y TextTransparency.
Determina si se renderizarán los GuiObject y sus descendientes.
Determina el orden en que un GuiObject renderiza en relación con los demás.
Describe la posición actual de la pantalla de un elemento GuiBase2d , en píxeles.
Describe la rotación de la pantalla actual de un elemento GuiBase2d en grados.
Describe el tamaño de la pantalla actual de un elemento GuiBase2d , en píxeles.
Cuando se establece en true, la localización se aplicará a este GuiBase2d y a sus descendientes.
Una referencia a un LocalizationTable para usar para aplicar localización automatizada a este GuiBase2d y sus descendientes.
Personaliza el comportamiento de selección del gamepad en la dirección de abajo.
Personaliza el comportamiento de selección del gamepad en la dirección izquierda.
Personaliza el comportamiento de selección del gamepad en la dirección correcta.
Personaliza el comportamiento de selección del gamepad en la dirección de arriba.
Permite la personalización del movimiento de selección del gamepad.
Métodos
Métodos heredados de GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Mueve suavemente una GUI a una nueva 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
Mueve suavemente una GUI a un nuevo tamaño y posición.
Eventos
Se activa cuando el botón está activado.
Se enciende cuando el mouse del usuario hace clic completo en el GuiButton .
Se enciende cuando el usuario presiona el botón izquierdo del mouse hacia abajo en el GuiButton .
Se enciende cuando el usuario suelta el botón izquierdo del mouse fuera del GuiButton .
Se enciende cuando el mouse del usuario hace clic derecho completo en el GuiButton .
Se enciende cuando el usuario presiona el botón derecho del ratón hacia abajo en el GuiButton .
Se enciende cuando el usuario suelta el botón derecho del mouse fuera del GuiButton .
Despedido cuando un usuario comienza a interactuar a través de un dispositivo de interfaz humana-computadora (botón del mouse hacia abajo, toque de inicio, botón de teclado hacia abajo, etc.).
Despedido cuando un usuario cambia la forma en que interactúa a través de un dispositivo de interfaz humana-computadora (botón del mouse hacia abajo, toque de inicio, botón de teclado hacia abajo, etc.).
Despedido cuando un usuario deja de interactuar a través de un dispositivo de interfaz humana-ordenador (botón del ratón hacia abajo, toque de inicio, botón de teclado hacia abajo, etc.).
Se activa cuando un usuario mueve el mouse a un elemento de interfaz gráfica.
Se activa cuando un usuario mueve el mouse fuera de un elemento de interfaz gráfica.
Se activa cada vez que un usuario mueve el mouse mientras está dentro de un elemento de interfaz gráfica.
Se activa cuando un usuario desplaza la rueda del ratón hacia atrás cuando el ratón está sobre un elemento de interfaz gráfica.
Se activa cuando un usuario desplaza la rueda del ratón hacia adelante cuando el ratón está sobre un elemento de interfaz gráfica.
Se desfija cuando el GuiObject se está enfocando con el seleccionador de Gamepad.
Despedido cuando el seleccionador de Gamepad deja de centrarse en el GuiObject.
Se enciende cuando el jugador comienza, continúa y detiene presionando largamente el elemento de la interfaz de usuario.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Se activa cuando el jugador mueve el dedo en el elemento de la interfaz de usuario.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Se activa cuando el jugador realiza un gesto de pinzamiento 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
Se activa 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 deslizamiento 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 : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Se enciende cuando la selección del gamepad se mueve a, deja o cambia dentro del conectado GuiBase2d o cualquier descendiente GuiObjects .
Propiedades
AutoButtonColor
Esta propiedad determina si el botón cambia automáticamente de color cuando el usuario lo pasa por encima o lo hace clic. MouseSi true , el botón cambiará automáticamente de color cuando el mouse se desplace sobre él o lo haga clic.Si false , el botón no cambiará.
Si desea personalizar cómo cambia un botón cuando el mouse del usuario se desplaza sobre él o lo hace clic, considere usar un ImageButton y cambiar el elemento HoverImage y PressedImage.
Tenga en cuenta que esta propiedad no tendrá ningún efecto en un ImageButton si su propiedad Image está configurada como una imagen.Además, esta propiedad no afectará a un ImageButton al pasar el mouse cuando su HoverImage no sea nil , ni al hacer clic en el mouse si su PressedImage no es nil .
HoverHapticEffect
Una instancia HapticEffect que se reproducirá cuando se esté pasando por encima del GuiButton .
Modal
Si true mientras el elemento de la interfaz de usuario es visible, el ratón no se bloqueará a menos que el botón derecho del ratón esté hacia abajo.
Métodos
Eventos
Activated
Se activa cuando el botón está activado.Como este evento no se dispara en el servidor, solo debe usarse en un LocalScript , o en un Script con RunContext de Enum.RunContext.Client .
Parámetros
MouseButton1Click
Este evento se activa cuando el mouse del usuario hace clic completo en el GuiButton .
En lo que respecta al clic, el mouse debe estar dentro de los límites de la etiqueta GuiButton y el botón del mouse debe presionarse hacia abajo y hacia arriba nuevamente antes de que se active este evento.Si el mouse sale de los límites del GuiButton y se libera, el evento no se desencadenar.Si desea evitar esta limitación, puede usar MouseButton1Down y MouseButton1Up ; estos eventos son similares, pero se dispararán cada vez que el usuario presione el botón izquierdo del mouse hacia abajo o hacia arriba, respectivamente.
MouseButton1Down
Este evento se activa cuando el usuario presiona el botón izquierdo del mouse hacia abajo en el GuiButton .
Para un evento que requiere que el usuario presione y para liberar su mouse izquierdo en un GuiButton para que el evento se desencadenar, considere usar MouseButton1Click .
Parámetros
La coordenada de la pantalla de la ratón X en píxeles.
La coordenada de la pantalla del ratón Y en píxeles.
MouseButton1Up
Este evento se activa cuando el usuario suelta el botón izquierdo del mouse fuera del GuiButton .
Para un evento que requiere que el usuario presione y para liberar su mouse izquierdo en un GuiButton para que el evento se desencadenar, considere usar MouseButton1Click .
Parámetros
La coordenada de la pantalla de la ratón X en píxeles.
La coordenada de la pantalla del ratón Y en píxeles.
MouseButton2Click
Este evento se activa cuando el mouse del usuario hace clic derecho completo en el GuiButton .
En lo que respecta al clic, el mouse debe estar dentro de los límites de la etiqueta GuiButton y el botón del mouse debe presionarse hacia abajo y hacia arriba nuevamente antes de que se active este evento.Si el mouse sale de los límites del GuiButton y se libera, el evento no se desencadenar.Si desea evitar esta limitación, puede usar MouseButton2Down y MouseButton2Up ; estos eventos son similares, pero se dispararán cada vez que el usuario presione el botón derecho del ratón hacia abajo o hacia arriba, respectivamente.
MouseButton2Down
Este evento se activa cuando el usuario presiona el botón derecho del ratón hacia abajo en el GuiButton .
Para un evento que requiere que el usuario presione y para liberar su mouse derecho en un GuiButton para que el evento se desencadenar, considere usar MouseButton2Click .
Parámetros
La coordenada de la pantalla de la ratón X en píxeles.
La coordenada de la pantalla del ratón Y en píxeles.
MouseButton2Up
Este evento se activa cuando el usuario suelta el botón derecho del ratón fuera del GuiButton.
Para un evento que requiere que el usuario presione y para liberar su mouse derecho en un GuiButton para que el evento se desencadenar, considere usar MouseButton2Click .
Parámetros
La coordenada de la pantalla de la ratón X en píxeles.
La coordenada de la pantalla del ratón Y en píxeles.