UIGridStyleLayout

UIGridStyleLayout : Instance

Overview

UI 요소들을 격자 또는 리스트 형태로 자동 배치하기 위한 레이아웃의 기반 클래스입니다.

UIGridStyleLayout은 클라이언트 환경에서만 제어할 수 있습니다.

Properties

AbsoluteContentSize

Vector2

레이아웃 내부의 요소들이 실제로 차지하는 전체 공간을 나타내는 읽기 전용 속성으로, 요소 간 간격(Padding)까지 포함한 실측 크기를 의미합니다.

Code Samples

local ScreenGui = script.Parent
local Frame = ScreenGui:WaitForChild("Frame")
local UIListLayout = Frame:WaitForChild("UIListLayout")

print(UIListLayout.AbsoluteContentSize)

FillDirection

Enum.FillDirection

UI 요소들이 나열되는 기본 축을 지정합니다.

가로 방향(Horizontal)일 경우 요소들이 좌→우 순서로 나열되고, 세로 방향(Vertical)일 경우 위→아래 흐름으로 배열됩니다.

정방향이 아닌 거꾸로 정렬하고 싶을 때는 FillDirection만으로는 제어할 수 없으며, LayoutOrder 기반 정렬을 이용해 순서를 반전시키는 방식으로 구현해야 합니다.

Code Samples

local ScreenGui = script.Parent
local Frame = ScreenGui:WaitForChild("Frame")
local UIListLayout = Frame:WaitForChild("UIListLayout")

UIListLayout.FillDirection = Enum.FillDirection.Horizontal

HorizontalAlignment

Enum.HorizontalAlignment

UI 요소들이 부모 컨테이너 안에서 수평 방향으로 어떤 기준점에 맞춰 배치될지를 결정하는 속성입니다.

텍스트의 가로 정렬(TextXAlignment)과 유사하게, 요소들의 묶음을 왼쪽 정렬, 가운데 정렬, 오른쪽 정렬 중 어떤 방식으로 배치할지 지정할 수 있습니다.

Code Samples

local ScreenGui = script.Parent
local Frame = ScreenGui:WaitForChild("Frame")
local UIListLayout = Frame:WaitForChild("UIListLayout")

UIListLayout.HorizontalAlignment = Enum.HorizontalAlignment.Center

SortOrder

Enum.SortOrder

레이아웃이 여러 UI 요소를 화면에 나열할 때 어떤 규칙으로 순서를 정할지를 지정합니다.

LayoutOrder은 각 요소가 가진 LayoutOrder 숫자를 기준으로 가장 작은 값부터 순서대로 배치됩니다. 같은 숫자를 가진 요소가 둘 이상이면, 부모에 더 일찍 추가된 요소가 먼저 위치합니다.

Name은 각 요소의 Name 값을 문자·숫자 조합 순서로 정렬하여 배치합니다.

Code Samples

local ScreenGui = script.Parent
local Frame = ScreenGui:WaitForChild("Frame")
local UIListLayout = Frame:WaitForChild("UIListLayout")

UIListLayout.SortOrder = Enum.SortOrder.LayoutOrder

VerticalAlignment

Enum.VerticalAlignment

UI 요소들이 부모 컨테이너 안에서 수직 방향으로 어떤 기준점에 맞춰 배치될지를 결정하는 속성입니다.

텍스트의 세로 정렬(TextYAlignment)과 유사하게, 요소들의 묶음을 상단 정렬, 가운데 정렬, 하단 정렬 중 어떤 방식으로 배치할지 지정할 수 있습니다.

Code Samples

local ScreenGui = script.Parent
local Frame = ScreenGui:WaitForChild("Frame")
local UIListLayout = Frame:WaitForChild("UIListLayout")

UIListLayout.VerticalAlignment = Enum.VerticalAlignment.Center

Methods

Events

See also

GUI