Un ScrollingFrame consiste en un lienzo personalizable **** y barras de desplazamiento con interactividad de desplazamiento integrada y diferentes maneras de personalizar cómo funciona el desplazamiento. ScrollingFrame es ideal para mostrar mucha información en un espacio limitado y funciona bien con lista y cuadrícula diseños.
Lienzana
El lienzo es el área principal de un ScrollingFrame que puede contener otro GuiObjects .El comportamiento de desplazamiento se adapta automáticamente en los siguientes escenarios:
| Configuración de marco | Resultado |
|---|---|
| El marco de CanvasSize es más alto que su altura total; específicamente, el total de CanvasSize.Y excede el total de Size.Y. | Se habilita el desplazamiento vertical y aparece una barra de desplazamiento vertical. |
| El marco de CanvasSize es más ancho que su ancho total; específicamente, el total de CanvasSize.X excede el total de Size.X. | Se habilita el desplazamiento horizontal y aparece una barra de desplazamiento horizontal. |
| El marco de AutomaticCanvasSize está configurado para Y o XY y la altura total de su contenido (niño GuiObjects ) excede su altura total Size.Y. | Se habilita el desplazamiento vertical y aparece una barra de desplazamiento vertical. |
| El marco de AutomaticCanvasSize está configurado para X o XY y el ancho total de su contenido (niño GuiObjects ) excede su ancho total Size.X. | Se habilita el desplazamiento horizontal y aparece una barra de desplazamiento horizontal. |
La propiedad refleja el desplazamiento posicional actual del lienzo dentro del marco, en píxeles, y establece la posición de las barras de desplazamiento en consecuencia.Tenga en cuenta que esta propiedad no hace nada si las barras de desplazamiento no son visibles.
Insercciones
El marco desplazable CanvasSize puede verse afectado por las propiedades VerticalScrollBarInset y/o HorizontalScrollBarInset.En el siguiente diagrama de ejemplo, un marco de desplazamiento vertical utiliza un ancho de lienzo del 100%.Con VerticalScrollBarInset configurado a None (predeterminado), el lienzo se extiende a la anchura completa del marco de desplazamiento, ocultando una pequeña cantidad de contenido debajo de la barra de desplazamiento.En contraste, un VerticalScrollBarInset ajuste de cualquiera de Always o ScrollBar inserta el lienzo por la cantidad ScrollBarThickness para que el lienzo se encuentre al borde con la barra de desplazamiento.
Barras de desplazamiento
Las barras de desplazamiento del marco reflejan la posición del lienzo actual y proporcionan una interactividad de desplazamiento automático .Para las barras de desplazamiento verticales, la propiedad VerticalScrollBarPosition cambia la posición de la barra a la izquierda o a la derecha del lienzo, pero las barras de desplazamiento horizontales solo se pueden posicionar debajo del lienzo.
La construcción de la barra de desplazamiento consiste en tres propiedades de activos:
- TopImage — Se muestra en la parte superior de una barra de desplazamiento vertical o en la izquierda de una barra de desplazamiento horizontal (rotada 90° en sentido horario para una barra de desplazamiento horizontal).
- MidImage — Cubre el área entre TopImage y BottomImage (rotado 90° en sentido horario para una barra de desplazamiento horizontal).
- BottomImage — Se muestra en la parte inferior de una barra de desplazamiento vertical, o a la derecha de una barra de desplazamiento horizontal (rotada 90° en sentido horario para una barra de desplazamiento horizontal).
Cada imagen se escala según la propiedad ScrollBarThickness que cambia el ancho de una barra de desplazamiento vertical o la altura de una barra de desplazamiento horizontal.
Se pueden realizar modificaciones visuales adicionales a través de las propiedades ScrollBarImageColor3 y ScrollBarImageTransparency que tiñen los recursos de imagen de la barra y modifican su opacidad, respectivamente.
Elasticidad
Por defecto, ScrollingFrames exhibe el comportamiento de desplazamiento elástico en dispositivos habilitados para el tacto, lo que significa que los usuarios pueden arrastrar el lienzo un poco más allá de sus límites y, al liberar, el lienzo se revertirá a su límite mínimo o máximo.Si quieres eliminar el comportamiento elástico completamente y asegurarte de que el lienzo nunca se desplace más allá de sus límites, establece la propiedad ElasticBehavior a Never.