ScreenGui

ScreenGui : LayerCollector

Overview

ScreenGui는 사용자의 화면에 표시되는 2D UI 요소(GuiObject)를 담는 컨테이너입니다. 실제로 화면에 나타나기 위해서는 해당 ScreenGui가 플레이어의 PlayerGui에 배치되어 있어야 하며, StarterGui에 넣어두면 플레이어가 게임에 입장하고 캐릭터가 처음 생성될 때 자동으로 각 플레이어의 PlayerGui로 복제됩니다.

ScreenGui에는 Frame, TextLabel, ImageButton 등 다양한 UI 구성 요소들을 자식으로 포함할 수 있습니다.

또한 성능 최적화를 위해 ScreenGui는 내부적으로 렌더링 결과를 캐싱하여 변화가 없을 때는 이를 재사용합니다. 그러나 ScreenGui 자체의 속성 변화, 자식 요소의 속성 변경, 또는 자식 요소의 추가/삭제가 발생하면 캐시가 무효화되며, 다음 렌더링 프레임에서 화면 정보가 다시 계산됩니다.

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

Properties

DisplayOrder

number

여러 ScreenGui가 동시에 표시될 때 어떤 순서로 화면에 겹쳐 보일지를 정의합니다. DisplayOrder 값이 더 큰 ScreenGui는 값이 작은 ScreenGui보다 앞쪽에 배치되어, 시각적으로 위에 나타나게 됩니다.

0~999,999,999 범위의 정수를 입력할 수 있습니다. 기본값은 0이며, 값이 클수록 다른 ScreenGui보다 우선적으로 표시됩니다.

Code Samples

local ScreenGui = script.Parent

ScreenGui.DisplayOrder = 2

Methods

Events

See aslo

GUI