滾動框架

*此內容是使用 AI（Beta 測試版）翻譯，可能含有錯誤。若要以英文檢視此頁面，請按一下這裡。

A ScrollingFrame 由可自訂的 畫布 和 滾動條 組成，內置了滾動互動性和不同的方法來自訂滾動操作的方式。ScrollingFrame 非常適合在有限空間中顯示大量信息，並且與 列表 和 網格 布局相容。

Example ScrollingFrame on the screen containing a tabbed category bar and a list of magical items for the player to consider purchasing.

畫布

繪圖板是包含其他繪圖板的主區域。滾動行為會自動適應以下情況：

框架設定結果
框架的 CanvasSize 比整體高度更高；特別是總 CanvasSize.Y 超過了總 Size.Y 。垂直捲動已啟用，並出現垂直捲動條。
框架的 CanvasSize 比整體寬度更寬；特別是總計 CanvasSize.X 超過了總計 Size.X 。垂直滾動已啟用，並出現一個垂直滾動條。
框架的 AutomaticCanvasSize 設為 Y 或 XY ，其內容（子 GuiObjects ）的總高度超過其總 Size.Y 。垂直捲動已啟用，並出現垂直捲動條。
框架的 AutomaticCanvasSize 設為 X 或 XY ，其內容（子 GuiObjects ）的總寬度超過其總 Size.X 。垂直滾動已啟用，並出現一個垂直滾動條。

CanvasPosition反映了框架內畫布的 當前 位置偏移，以像素為單位,並依此設置滾動條的位置。請注意，如果滾動條不可見，此屬性將無任何作用。

插入

滾動框架的 CanvasSize 可能會受到 VerticalScrollBarInset 和/或 HorizontalScrollBarInset 屬性的影響。在下列示例圖中，垂直滾動框使用畫布寬度為 100%。將 VerticalScrollBarInset 設為 None (預設值)，畫布會擴展到滾動框的全寬度，擋住了滾動條下少量內容。相反地，將 VerticalScrollBarInset 設置為 Always 或 ScrollBar 插入畫布的 ScrollBarThickness 量，使畫布與滾動條邊緣對齊。

滾動條

框架的 滾動條 反映當前畫布位置，並提供自動拖曳到滾動互動性。對於垂直滾動條，VerticalScrollBarPosition屬性將條的位置切換為畫布左側或右側，但水平滾動條只能位於畫布下方。

滾動條的建造包括三個資產屬性：

  • TopImage — 在垂直滾動條的頂部或水平滾動條的左側顯示（對於水平滾動條，旋轉 90° 逆時針）。
  • MidImage — 橫跨 TopImage 和 BottomImage 之間的區域（旋轉 90° 逆時針為水平滾動條）。
  • BottomImage — 在垂直滾動條的底部或水平滾動條的右側顯示（對於水平滾動條，旋轉 90° 逆時針）。
Diagram showing the three image asset elements which construct a scrolling frame's scroll bar.

每張圖像的縮放基於 ScrollBarThickness 屬性，該屬性會改變垂直滾動條或水平滾動條的寬度或高度。

額外的視覺修改可以通過 ScrollBarImageColor3 和 ScrollBarImageTransparency 屬性進行，這些屬性會對條形圖圖像資產進行染色並修改其不透明度，分別。

彈性

預設情況下，ScrollingFrames 在啟用觸碰的裝置上展示彈性滾動行為，這意味著使用者可以將畫布稍微拖出其邊界，並在釋放時畫布將回到其最小或最大限度。如果您想完全移除彈性行為並確保畫布永遠不會超出限制，請將 ElasticBehavior 屬性設置為 Never 。