GuiButton
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
GuiButton é uma classe abstrata que herda de GuiObject.É a classe base para os objetos interativos, clicáveis ImageButton e TextButton .Esta classe também define várias propriedades para comportamento interativo, a saber AutoButtonColor e Modal.
O evento mais importante de um GuiButton é Activated, um evento multiplataforma que dispara quando o botão é ativado.Ao usar um mouse, isso significa clicar no botão e soltar com o cursor ainda sobre o Objetoda interface.Para toque, o mesmo se aplica, mas com um toque em vez de pressionar um botão.Finalmente, para gamepads, Activated fogos se um GuiButton for selecionado quando o botão A for pressionado e liberado.Em suma, este evento é muito útil para a programação de interface de usuário multiplataforma, pois fornece uma interface geral agradável para uma única entrada de usuário.
Resumo
Propriedades
Determina se o botão muda automaticamente de cor quando o mouse passa por cima ou clica nele.
Uma instância HapticEffect que tocará quando o GuiButton estiver sendo movido.
Se true enquanto o elemento GUI está visível, o mouse não será bloqueado a menos que o botão direito do mouse esteja pressionado.
Uma instância HapticEffect que será reproduzida quando o GuiButton for pressionado.
Uma propriedade booleana que indica se o objeto foi selecionado.
Define o estilo do GuiButton com base em uma lista de estilos predefinidos.
Determina se este elemento de UI afunda a entrada.
Determina o ponto de origem de um GuiObject , em relação ao seu tamanho absoluto.
Determina se o redimensionamento ocorre com base no conteúdo da criança.
Determina a cor de fundo GuiObject .
Determina a transparência do plano de fundo e da borda GuiObject.
Determina a cor da borda GuiObject .
Determina de que maneira a borda GuiObject é disposta em relação às suas dimensões.
Determina a largura do pixel da borda GuiObject .
Determina se descendente GuiObjects fora dos limites de um elemento GUI pai deve renderizar.
Determina se o mouse do jogador está sendo pressionado ativamente no GuiObject ou não.
Determina se o GuiButton pode ser interagido ou não, ou se o GuiState do GuiObject está mudando ou não.
Controla a ordem de classificação do GuiObject quando usado com um UIGridStyleLayout .
Define o GuiObject que será selecionado quando o seletor de gamepad for movido para baixo.
Define o GuiObject que será selecionado quando o seletor de gamepad for movido para a esquerda.
Define o GuiObject que será selecionado quando o seletor de gamepad for movido para a direita.
Define o GuiObject que será selecionado quando o seletor de gamepad for movido para cima.
Determina a posição do pixel e escalar da GuiObject .
Determina o número de graus em que o GuiObject é girado.
Determine se o GuiObject pode ser selecionado por um controle / controle de jogo.
Substitui o adorno de seleção padrão usado para gamepads.
A ordem de GuiObjects selecionada pela seleção da interface do gamepad.
Determina o tamanho do pixel e escalar do GuiObject .
Define os eixos Size que o GuiObject será baseado, em relação ao tamanho de seu pai.
Uma propriedade mista de BackgroundTransparency e TextTransparency.
Determina se o GuiObject e seus descendentes serão renderizados.
Determina a ordem em que um GuiObject renderiza em relação aos outros.
Descreve a posição real da tela de um elemento GuiBase2d , em pixels.
Descreve a rotação real da tela de um elemento GuiBase2d em graus.
Descreve o tamanho real da tela de um elemento GuiBase2d , em pixels.
Quando definido para true , a localização será aplicada a este GuiBase2d e 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 de 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 a personalização do movimento de seleção do gamepad.
Métodos
Métodos herdados de GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Mova suavemente uma GUI para um novo 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
Mova suavemente uma GUI para um novo tamanho e posição.
Eventos
Dispara quando o botão é ativado.
Incêndios quando o mouse do usuário clica totalmente no GuiButton .
Incêndios quando o usuário pressiona o botão esquerdo do mouse para baixo no GuiButton.
Incêndios quando o usuário solta seu botão esquerdo do mouse fora do GuiButton.
Incêndios quando o mouse do usuário clica totalmente com o botão direito no GuiButton .
Dispara quando o usuário pressiona o botão direito do mouse para baixo no GuiButton.
Incêndios quando o usuário solta o botão direito do mouse fora do GuiButton.
Dispedido quando um usuário começa a interagir através de um dispositivo de Interface Humano-Computador (botão do mouse para baixo, toque começa, botão do teclado para baixo, etc).
Dispedido quando um usuário muda como está interagindo através de um dispositivo de Interface Humano-Computador (botão do mouse para baixo, toque começa, botão da tecla para baixo, etc).
Dispedido quando um usuário para de interagir através de um dispositivo de Interface Humano-Computador (botão do mouse para baixo, toque começar, botão da tecla para baixo, etc).
Dispara quando um usuário move o mouse para um elemento de GUI.
Dispara quando um usuário move o mouse para fora de um elemento de GUI.
Incêndios sempre que um usuário move o mouse enquanto ele está dentro de um elemento de GUI.
Dispara quando um usuário rola a roda do mouse de volta quando o mouse está sobre um elemento de GUI.
Dispara quando um usuário rola a roda do mouse para a frente quando o mouse está sobre um elemento de GUI.
Disparado quando o GuiObject está sendo focado no seletor Gamepad.
Dispedido quando o seletor de Gamepad para de se concentrar no GuiObject.
Incêndios quando o jogador começa, continua e para de apertar a tecla da interface de usuário por muito tempo.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Dispara quando o jogador move o dedo sobre o elemento da interface.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Incêndios quando o jogador executa um gesto de pinça ou puxão usando dois dedos no elemento da interface.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Incêndios quando o jogador executa um gesto de rotação usando dois dedos no elemento da interface.
Incêndios quando o jogador executa um gesto de deslize no elemento da interface.
Dispara quando o jogador executa um gesto de toque no elemento da interface.
- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Incêndios quando a seleção do gamepad se move para, deixa ou muda dentro do conectado GuiBase2d ou qualquer descendente GuiObjects.
Propriedades
AutoButtonColor
Essa propriedade determina se o botão muda automaticamente de cor quando o usuário passa por cima ou clica nele. MouseSe true , o botão mudará automaticamente de cor quando o mouse passar por cima ou clicar nele.Se false , o botão não mudará.
Se você quiser personalizar como um botão muda quando o mouse do usuário passa por cima ou clica nele, considere usar um ImageButton e alterar o elemento HoverImage e PressedImage.
Observe que essa propriedade não terá efeito em um ImageButton se sua propriedade Image estiver definida para uma imagem.Além disso, essa propriedade não afetará um ImageButton ao passar o mouse quando seu HoverImage não for nil , nem ao clicar no mouse se seu PressedImage não for nil .
Modal
Se true enquanto o elemento GUI está visível, o mouse não será bloqueado a menos que o botão direito do mouse esteja pressionado.
PressHapticEffect
Uma instância HapticEffect que será reproduzida quando o GuiButton for pressionado.
Métodos
Eventos
Activated
Dispara quando o botão é ativado.Como este evento não é disparado no servidor, ele só deve ser usado em um LocalScript ou em um Script com RunContext de Enum.RunContext.Client.
Parâmetros
MouseButton1Click
Este evento é disparado quando o mouse do usuário clica totalmente no GuiButton.
Em relação ao clique, o mouse deve estar dentro dos limites do GuiButton e o botão do mouse deve ser pressionado para baixo e novamente antes que este evento seja disparado.Se o mouse sair dos limites do GuiButton e for liberado, o evento não será Iniciar / executar.Se você quiser evitar essa limitação, você pode usar MouseButton1Down e MouseButton1Up ; esses eventos são semelhantes, mas serão disparados sempre que o usuário pressionar o botão esquerdo do mouse para baixo ou para cima, respectivamente.
MouseButton1Down
Este evento é disparado quando o usuário pressiona o botão esquerdo do mouse para baixo no GuiButton.
Para um evento que requer que o usuário pressione e para liberar seu mouse esquerdo em um GuiButton a fim de Iniciar / executaro evento, considere usar MouseButton1Click.
Parâmetros
A coordenada de tela do mouse X em pixels.
A coordenada de tela do mouse Y em pixels.
MouseButton1Up
Este evento dispara quando o usuário solta seu botão esquerdo do mouse fora do GuiButton.
Para um evento que requer que o usuário pressione e para liberar seu mouse esquerdo em um GuiButton a fim de Iniciar / executaro evento, considere usar MouseButton1Click.
Parâmetros
A coordenada de tela do mouse X em pixels.
A coordenada de tela do mouse Y em pixels.
MouseButton2Click
Este evento é disparado quando o mouse do usuário clica totalmente com o botão direito em GuiButton .
Em relação ao clique, o mouse deve estar dentro dos limites do GuiButton e o botão do mouse deve ser pressionado para baixo e novamente antes que este evento seja disparado.Se o mouse sair dos limites do GuiButton e for liberado, o evento não será Iniciar / executar.Se você quiser evitar essa limitação, você pode usar MouseButton2Down e MouseButton2Up ; esses eventos são semelhantes, mas serão disparados sempre que o usuário pressionar o botão direito do mouse para baixo ou para cima, respectivamente.
MouseButton2Down
Este evento é disparado quando o usuário pressiona o botão direito do mouse para baixo no GuiButton.
Para um evento que requer que o usuário pressione e para liberar o mouse direito em um GuiButton a fim de o evento Iniciar / executar, considere usar MouseButton2Click.
Parâmetros
A coordenada de tela do mouse X em pixels.
A coordenada de tela do mouse Y em pixels.
MouseButton2Up
Este evento dispara quando o usuário solta o botão direito do mouse fora do GuiButton.
Para um evento que requer que o usuário pressione e para liberar o mouse direito em um GuiButton a fim de o evento Iniciar / executar, considere usar MouseButton2Click.
Parâmetros
A coordenada de tela do mouse X em pixels.
A coordenada de tela do mouse Y em pixels.