ScrollingFrame

ScrollingFrame : GuiObject

Overview

자식 요소를 클리핑하고, 컨텐츠가 표시 영역을 넘어갈 때 수평/수직 스크롤을 제공하는 컨테이너입니다. 긴 목록, 채팅, 인벤토리 등 오버플로우가 발생하는 UI에 적합합니다.

Properties

AbsoluteCanvasSize

Vector2

레이아웃 적용 후 전체 스크롤 가능한 컨텐츠의 픽셀 단위 크기(읽기 전용)입니다. 현재 창 크기와 관계없이 컨텐츠의 전체 범위를 파악할 때 사용합니다.

Code Samples

AbsoluteWindowSize

Vector2

보이는 영역(뷰포트)의 픽셀 단위 크기(읽기 전용)입니다. 스크롤 없이 컨텐츠가 표시되는 내부 창 크기에 해당합니다.

Code Samples

AutomaticCanvasSize

Enum.AutomaticSize

자식 및 레이아웃에 따라 CanvasSize를 자동으로 조절합니다. 수동으로 관리하려면 None으로 설정하세요.

Code Samples

CanvasSize

UDim2

스크롤 가능한 전체 컨텐츠 영역의 크기입니다. 창보다 크면 설정 및 ScrollingDirection에 따라 스크롤바가 표시될 수 있습니다.

Code Samples

local frame = Instance.new("ScrollingFrame")
frame.Size = UDim2.new(0, 300, 0, 200)
frame.CanvasSize = UDim2.new(0, 300, 0, 800) -- 창보다 컨텐츠가 커지면 세로 스크롤
frame.Parent = script.Parent

CanvasPosition

Vector2

현재 스크롤 오프셋(픽셀)입니다. X는 가로, Y는 세로 스크롤을 의미합니다. 스크립트로 설정하면 뷰포트가 해당 위치로 이동합니다.

Code Samples

local frame = script.Parent -- ScrollingFrame
frame.CanvasPosition = Vector2.new(0, 120) -- 세로로 120px 이동

ScrollBarImageColor3

Color3

스크롤바 비주얼(트랙/핸들)에 적용되는 틴트 색상입니다. 테마를 맞추는 데 사용합니다.

Code Samples

ScrollBarImageTransparency

number

스크롤바 비주얼의 투명도입니다. 0은 불투명, 1은 완전 투명입니다.

Code Samples

ScrollBarThickness

number

스크롤바의 두께(픽셀)입니다. 터치 환경에서는 두껍게, 공간 절약을 위해서는 얇게 설정하세요.

Code Samples

ScrollingDirection

Enum.ScrollingDirection

허용되는 스크롤 축을 제어합니다: X(가로), Y(세로), XY(둘 다). 사용자 입력 처리 및 CanvasPosition 클램핑에 영향을 줍니다.

Code Samples

ScrollingEnabled

bool

true일 때 사용자 스크롤이 활성화됩니다. false일 때는 사용자 입력으로 스크롤되지 않지만, 스크립트로 CanvasPosition을 변경할 수 있습니다.

Code Samples

Methods

MoveToSlot

지정된 슬롯 인덱스의 항목이 보이도록 스크롤 뷰포트를 이동합니다. 가상화 리스트나 슬롯 기반 UI에서 사용됩니다.

Parameters

unumber32 SlotIndex

Return

void

Code Samples

-- 예: 가상화된 리스트에서 인덱스 50의 항목으로 이동
local list = script.Parent -- ScrollingFrame
if list.MoveToSlot then
    list:MoveToSlot(50)
end

Events