GuiBase2d

GuiBase2d : Instance

Overview

2D GuiObject들의 기반이 되는 추상 클래스입니다.

Properties

AbsolutePosition

Vector2

UI 요소가 실제 화면상에 렌더링되는 위치를 픽셀 단위로 나타내는 속성입니다.

이 값은 부모 UI 요소들의 위치와 크기를 모두 반영한 최종 계산 결과이며, 항상 요소의 좌측 상단을 기준으로 합니다.

Code Samples

local ScreenGui = script.Parent
local TextLabel = ScreenGui.TextLabel

print("AbsolutePosition : ", TextLabel.AbsolutePosition)

AbsoluteSize

Vector2

UI 요소가 화면에 렌더링될 때 적용되는 실제 크기를 픽셀 단위로 나타내는 속성입니다.

이 값은 부모의 크기, AnchorPoint, Scale 등의 설정이 모두 반영된 결과값으로, 화면에서 해당 요소가 차지하는 최종 크기를 정확하게 확인할 수 있습니다.

Code Samples

local ScreenGui = script.Parent
local TextLabel = ScreenGui.TextLabel

print("AbsoluteSize : ", TextLabel.AbsoluteSize)

AutoLocalize

boolean

이 GuiBase2d와 그 자손에 자동 로컬라이제이션(Auto Translation)을 적용할지 여부를 지정하는 속성으로, AutoLocalize가 true이면 자동 텍스트 수집(ATC) 대상에도 포함됩니다.

기본값은 true이며, false로 설정하면 해당 객체와 자식 트리전체에서 자동 번역이 비활성화됩니다.

상속 규칙은 다음과 같습니다.

• 자식의 AutoLocalize가 false이면 해당 객체에는 번역이 적용되지 않습니다.

• 부모의 AutoLocalize가 false이면 자식의 값과 무관하게 번역이 적용되지 않습니다.

• 자식의 AutoLocalize가 true이면 부모의 AutoLocalize 설정을 따릅니다.

Code Samples

local ScreenGui = script.Parent
local TextLabel = ScreenGui:WaitForChild("TextLabel")

TextLabel.AutoLocalize = false

Methods

Events