Um > consiste em um canvas personalizável e barras de rolagem com interatividade de rolagem integrada e diferentes maneiras de personalizar como o rolagem funciona.ScrollingFrame é ideal para exibir muita informação em um espaço limitado e funciona bem com lista e grade layouts.
Tela
O canvas é a área principal de um ScrollingFrame que pode conter outro GuiObjects.O comportamento de rolagem se adapta automaticamente nos seguintes cenários:
| Configuração de Quadro | Resposta |
|---|---|
| O quadro de CanvasSize é mais alto que sua altura total; especificamente, o total de CanvasSize.Y excede o total de Size.Y. | Rolagem vertical é ativada e uma barra de rolagem vertical aparece. |
| O CanvasSize da moldura é mais amplo que sua largura geral; especificamente, o total CanvasSize.X excede o total Size.X. | A rolagem horizontal está ativada e uma barra de rolagem horizontal aparece. |
| O frame's AutomaticCanvasSize é definido como Y ou XY e a altura total de seu conteúdo (criança GuiObjects ) excede sua altura total Size.Y. | Rolagem vertical é ativada e uma barra de rolagem vertical aparece. |
| O frame's AutomaticCanvasSize é definido como X ou XY e a largura total de seu conteúdo (filho GuiObjects ) excede sua largura total Size.X. | A rolagem horizontal está ativada e uma barra de rolagem horizontal aparece. |
A propriedade CanvasPosition reflete o deslocamento posicional atual da tela dentro da janela, em pixels, e define a posição das barras de rolagem em conformidade.Observe que esta propriedade não faz nada se as barras de rolagem não estiverem visíveis.
Inserções
Uma janela de rolagem pode ser afetada pelas propriedades CanvasSize e/ou VerticalScrollBarInset e/ou HorizontalScrollBarInset.No seguinte exemplo de diagrama, um quadro de rolagem vertical usa uma largura de tela de 100%.Com VerticalScrollBarInset definido para None (padrão), o canvas se estende para a largura total da janela de rolagem, obscurecendo uma pequena quantidade de conteúdo sob a barra de rolagem.Em contraste, uma configuração de VerticalScrollBarInset inserindo o canvas pela quantia Always ou ScrollBar inserindo o canvas pela quantia ScrollBarThickness faz com que o canvas seja preenchido na borda com a barra de rolagem.
Barras de rolagem
As barras de rolagem do quadro refletem a posição atual do canvas e fornecem interatividade de arrastamento automático .Para barras de rolagem verticais, a propriedade VerticalScrollBarPosition muda a posição da barra para a esquerda ou direita da tela, mas as barras de rolagem horizontais só podem ser posicionadas abaixo da tela.
A construção da barra de rolagem consiste em três propriedades de recursos:
- TopImage — Exibe 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).
- MidImage — Cobre a área entre TopImage e BottomImage (rotacionado 90° para a direita para uma barra de rolagem horizontal).
- BottomImage — Exibe 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).
Cada imagem escala com base na propriedade ScrollBarThickness que altera a largura de uma barra de rolagem vertical ou a altura de uma barra de rolagem horizontal.
As modificações visuais adicionais podem ser feitas através das propriedades ScrollBarImageColor3 e ScrollBarImageTransparency, que tingem os recursos de imagem da barra e modificam sua opacidade, respectivamente.
Elasticidade
Por padrão, ScrollingFrames exibir o comportamento de rolagem elástica em dispositivos com suporte ao toque, o que significa que os usuários podem arrastar o canvas um pouco além de seus limites e, ao liberar, o canvas voltará ao seu limite mínimo ou máximo.Se você quiser remover completamente o comportamento elástico e garantir que a tela nunca seja deslocada além de seus limites, defina a propriedade ElasticBehavior para Never.