Una ScrollingFrame consiste in un canvas personalizzabile e in barre di scorrimento con interattività di scorrimento integrata e diversi modi per personalizzare il funzionamento dello scorrimento. La ScrollingFrame è ideale per visualizzare molte informazioni in uno spazio ristretto e funziona bene con i layout a lista e a griglia.
Canvas
Il canvas è l'area principale di una ScrollingFrame che può contenere altri GuiObjects. Il comportamento di scorrimento si adatta automaticamente nei seguenti scenari:
| Configurazione del Frame | Risultato |
|---|---|
| La CanvasSize del frame è più alta della sua altezza complessiva; specificamente, il totale di CanvasSize.Y supera il totale di Size.Y. | Lo scorrimento verticale è abilitato e appare una barra di scorrimento verticale. |
| La CanvasSize del frame è più larga della sua larghezza complessiva; specificamente, il totale di CanvasSize.X supera il totale di Size.X. | Lo scorrimento orizzontale è abilitato e appare una barra di scorrimento orizzontale. |
| La AutomaticCanvasSize del frame è impostata su Y o XY e l'altezza totale dei suoi contenuti (child GuiObjects) supera il totale di Size.Y. | Lo scorrimento verticale è abilitato e appare una barra di scorrimento verticale. |
| La AutomaticCanvasSize del frame è impostata su X o XY e la larghezza totale dei suoi contenuti (child GuiObjects) supera il totale di Size.X. | Lo scorrimento orizzontale è abilitato e appare una barra di scorrimento orizzontale. |
La proprietà CanvasPosition riflette l'offset corrente di posizione del canvas all'interno del frame, in pixel, e imposta la posizione delle barre di scorrimento di conseguenza. Si noti che questa proprietà non fa nulla se le barre di scorrimento non sono visibili.
Insieme
La CanvasSize di un frame di scorrimento può essere influenzata dalle proprietà VerticalScrollBarInset e/o HorizontalScrollBarInset. Nell'esempio seguente, un frame di scorrimento verticale utilizza una larghezza del canvas del 100%. Con VerticalScrollBarInset impostato su None (predefinito), il canvas si estende fino alla larghezza totale del frame di scorrimento, oscurando una leggera quantità di contenuto sotto la barra di scorrimento. Al contrario, un'impostazione di VerticalScrollBarInset di Always o ScrollBar insettano il canvas della quantità di ScrollBarThickness in modo che il canvas tocchi il bordo con la barra di scorrimento.
Barre di scorrimento
Le barre di scorrimento del frame riflettono la posizione corrente del canvas e forniscono interattività automatica di trascinamento per scorrere. Per le barre di scorrimento verticali, la proprietà VerticalScrollBarPosition cambia la posizione della barra a sinistra o a destra del canvas, ma le barre di scorrimento orizzontali possono essere posizionate solo sotto il canvas.
La costruzione della barra di scorrimento consiste in tre proprietà di risorse:
- TopImage — Viene visualizzata nella parte superiore di una barra di scorrimento verticale o a sinistra di una barra di scorrimento orizzontale (ruotata di 90° in senso antiorario per una barra di scorrimento orizzontale).
- MidImage — Si estende nell'area tra TopImage e BottomImage (ruotata di 90° in senso antiorario per una barra di scorrimento orizzontale).
- BottomImage — Viene visualizzata nella parte inferiore di una barra di scorrimento verticale o a destra di una barra di scorrimento orizzontale (ruotata di 90° in senso antiorario per una barra di scorrimento orizzontale).
Ogni immagine scala in base alla proprietà ScrollBarThickness, che cambia la larghezza di una barra di scorrimento verticale o l'altezza di una barra di scorrimento orizzontale.
Modifiche visive aggiuntive possono essere apportate tramite le proprietà ScrollBarImageColor3 e ScrollBarImageTransparency, che colorano gli asset immagine della barra e ne modificano l'opacità, rispettivamente.
Elasticità
Per impostazione predefinita, i ScrollingFrames mostrano un comportamento di scorrimento elastico su dispositivi abilitati al tocco, il che significa che gli utenti possono trascinare il canvas leggermente oltre i suoi limiti e, al rilascio, il canvas tornerà al suo limite minimo o massimo. Se desideri rimuovere completamente il comportamento elastico e assicurarti che il canvas non scorra mai oltre i suoi limiti, imposta la proprietà ElasticBehavior su Never.