ScrollingFrame
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
ScrollingFrame é um tipo especial Frame com interatividade de rolagem integrada e diferentes maneiras de personalizar como o rolagem funciona.
Resumo
Propriedades
O tamanho da área que pode ser deslocada, em ofertas.
O tamanho do quadro, em ofertas, sem as barras de rolagem.
Determina se ScrollingFrame.CanvasSize é redimensionado com base no conteúdo filho.
Imagem que é exibida na parte inferior de uma barra de rolagem vertical ou à direita de uma barra de rolagem horizontal (rotacionada 90° no sentido horário para uma barra de rolagem horizontal).
Reflete o deslocamento posicional atual da tela dentro da janela, em pixels, e define a posição das barras de rolagem de acordo.
Determina o tamanho da área scrollável.
Determina se e quando a rolagem elástica é permitida em dispositivos com suporte ao toque.
Indica se CanvasSize está inserido por ScrollBarThickness no eixo horizontal.
Imagem que cobre a área entre TopImage e BottomImage (rotacionada 90° no sentido horário para uma barra de rolagem horizontal).
Determina como as imagens da barra de rolagem renderizada são coloridas.
Determina a opacidade das imagens da barra de rolagem.
Espessura da barra de rolagem em pixels; aplica-se tanto às barras de rolagem horizontais quanto verticais.
Determina a direção(s) em que o rolamento é permitido.
Determina se a rolagem é permitida no quadro.
Imagem que é exibida na parte superior de uma barra de rolagem vertical ou à esquerda de uma barra de rolagem horizontal (rotacionada 90° para a direita para uma barra de rolagem horizontal).
Indica se CanvasSize está inserido por ScrollBarThickness no eixo vertical.
Indica se a barra de rolagem vertical está posicionada à esquerda ou à direita da tela.
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
Eventos herdados de GuiObjectDispedido 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
AbsoluteCanvasSize
O tamanho da área que pode ser deslocada, em ofertas.Essa propriedade é definida para o máximo da propriedade CanvasSize e o tamanho das crianças se AutomaticCanvasSize for definido para algo diferente de Enum.AutomaticSize.None.
AutomaticCanvasSize
Essa propriedade é usada para dimensionar automaticamente objetos de interface pai com base no tamanho de seus descendentes.Você pode usar essa propriedade para adicionar dinamicamente texto e outro conteúdo a um ScrollingFrame na hora de editar ou executar e o tamanho se ajustará para caber a esse conteúdo.
Quando esta propriedade é definida para um valor Enum.AutomaticSize diferente de None, AbsoluteCanvasSize pode redimensionar dependendo do conteúdo filho.
BottomImage
Imagem que é exibida na parte inferior de uma barra de rolagem vertical ou à direita de uma barra de rolagem horizontal (rotacionada 90° no sentido horário para uma barra de rolagem horizontal).
CanvasPosition
Reflete o deslocamento posicional atual da tela dentro da janela, em pixels, e define a posição das barras de rolagem de acordo.Observe que esta propriedade não faz nada se as barras de rolagem não estiverem visíveis.
CanvasSize
Determina o tamanho da área scrollável.Para uma alternativa adaptativa com base no tamanho geral das crianças dentro do ScrollingFrame, considere usar AutomaticCanvasSize.
ElasticBehavior
Essa propriedade determina se e quando a rolagem elástica é permitida em dispositivos com toque ativado. Padrão para WhenScrollable .
HorizontalScrollBarInset
Indica se CanvasSize está inserido por ScrollBarThickness no eixo horizontal.
MidImage
Imagem que cobre a área entre TopImage e BottomImage (rotacionada 90° no sentido horário para uma barra de rolagem horizontal).Essa imagem é automaticamente escalada para preencher o espaço entre os segmentos de tampa.
ScrollBarImageColor3
Determina como as imagens da barra de rolagem ( TopImage , MidImage , BottomImage ) são coloridas.Quando definido para branco, nenhuma colorização ocorre.Essa propriedade é útil para reutilizar recursos de imagem; se as imagens de origem forem completamente brancas com transparência, você pode definir a cor de toda a barra de rolagem de uma vez.
ScrollBarImageTransparency
Determina a opacidade das imagens da barra de rolagem ( TopImage , MidImage , BottomImage ).Um valor de 0 é completamente opaco e um valor de 1 é completamente transparente (invisível).
ScrollBarThickness
Espessura da barra de rolagem em pixels; aplica-se tanto às barras de rolagem horizontais quanto verticais. Se definido como 0, nenhuma barra de rolagem é renderizada.
ScrollingDirection
Essa propriedade determina a direção(s) em que o rolamento é permitido.Se a rolagem for proibida em uma direção, a barra de rolagem associada não aparecerá.Padrão para Enum.ScrollingDirection.XY .
ScrollingEnabled
Determina se a rolagem é permitida no quadro. Se false, nenhuma barra de rolagem será renderizada.
TopImage
Imagem que é exibida na parte superior de uma barra de rolagem vertical ou à esquerda de uma barra de rolagem horizontal (rotacionada 90° para a direita para uma barra de rolagem horizontal).
VerticalScrollBarPosition
Indica se a barra de rolagem vertical está posicionada à esquerda ou à direita da tela. Padrão para Enum.VerticalScrollBarPosition.Right .