Uma ScrollingFrame consiste em um canvas personalizável e barras de rolagem com interatividade de rolagem embutida e diferentes maneiras de personalizar como a rolagem funciona. A ScrollingFrame é ideal para exibir muitas informações em um espaço confinado e funciona bem com layouts de lista e grid.
Canvas
O canvas é a área principal de uma ScrollingFrame que pode conter outros GuiObjects. O comportamento de rolagem se adapta automaticamente nos seguintes cenários:
| Configuração do Frame | Resultado |
|---|---|
| O CanvasSize do frame é mais alto que sua altura total; especificamente, o total de CanvasSize.Y excede o total de Size.Y. | A rolagem vertical é habilitada e uma barra de rolagem vertical aparece. |
| O CanvasSize do frame é mais largo que sua largura total; especificamente, o total de CanvasSize.X excede o total de Size.X. | A rolagem horizontal é habilitada e uma barra de rolagem horizontal aparece. |
| O AutomaticCanvasSize do frame está definido como Y ou XY e a altura total de seus conteúdos (child GuiObjects) excede o total de Size.Y. | A rolagem vertical é habilitada e uma barra de rolagem vertical aparece. |
| O AutomaticCanvasSize do frame está definido como X ou XY e a largura total de seus conteúdos (child GuiObjects) excede o total de Size.X. | A rolagem horizontal é habilitada e uma barra de rolagem horizontal aparece. |
A propriedade CanvasPosition reflete o atualmente deslocamento posicional do canvas dentro do frame, 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.
Margens
O CanvasSize de um frame de rolagem pode ser afetado pelas propriedades VerticalScrollBarInset e/ou HorizontalScrollBarInset. No diagrama de exemplo abaixo, um frame de rolagem vertical utiliza uma largura de canvas de 100%. Com VerticalScrollBarInset definido como None (padrão), o canvas se estende até a largura total do frame de rolagem, obscurecendo uma quantidade ligeira de conteúdo sob a barra de rolagem. Em contraste, uma configuração de VerticalScrollBarInset de Always ou ScrollBar insere o canvas pela quantidade de ScrollBarThickness, de modo que o canvas fique em contato lado a lado com a barra de rolagem.
Barras de Rolagem
As barras de rolagem do frame refletem a posição atual do canvas e fornecem interatividade automática de arrastar para rolar. Para as barras de rolagem verticais, a propriedade VerticalScrollBarPosition muda a posição da barra para a esquerda ou direita do canvas, mas as barras de rolagem horizontais podem ser posicionadas apenas abaixo do canvas.
A construção da barra de rolagem consiste em três propriedades de ativos:
- TopImage — Exibe na parte superior de uma barra de rolagem vertical, ou à esquerda de uma barra de rolagem horizontal (rotacionada 90° no sentido anti-horário para uma barra de rolagem horizontal).
- MidImage — Abrevia a área entre TopImage e BottomImage (rotacionada 90° no sentido anti-horário 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 anti-horário para uma barra de rolagem horizontal).
Cada imagem é redimensionada com base na propriedade ScrollBarThickness, que altera a largura de uma barra de rolagem vertical ou a altura de uma barra de rolagem horizontal.
Modificações visuais adicionais podem ser feitas através das propriedades ScrollBarImageColor3 e ScrollBarImageTransparency, que respectivamente colorem os ativos de imagem da barra e modificam sua opacidade.
Elasticidade
Por padrão, os ScrollingFrames exibem um comportamento de rolagem elástica em dispositivos com toque, o que significa que os usuários podem arrastar o canvas ligeiramente além de seus limites e, ao soltar, o canvas retornará ao seu limite mínimo ou máximo. Se você quiser remover completamente o comportamento elástico e garantir que o canvas nunca role além de seus limites, defina a propriedade ElasticBehavior como Never.