# 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보다 앞쪽에 배치되어, 시각적으로 위에 나타나게 됩니다.

#### Code Samples

```lua
local ScreenGui = script.Parent

ScreenGui.DisplayOrder = 2
```

## Methods

## Events

## See aslo

{% content-ref url="/pages/K1g0tEWDJhh6a6E4UURk" %}
[GUI](/korean/manual/studio-manual/gui.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.overdare.com/korean/development/api-reference/classes/screengui.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.