`Class.BillboardGui`는 UI 객체들이 3D 공간에 표시되면서 항상 카메라를 향하도록 하는 컨테이너입니다. 컨테이너의 위치는 부모인 `Class.BasePart` 또는 `Class.Attachment` (또는 `Class.BillboardGui.Adornee|Adornee`)에 상대적입니다. `Class.BasePart|BaseParts`의 경우 `Class.BasePart.Position|Position` 속성이 사용되며, `Class.Attachment|Attachments`의 경우 `Class.Attachment.WorldPosition|WorldPosition` 속성이 사용됩니다.

<img src="/assets/ui/in-experience/BillboardGui-Diagram.jpg" width="800" alt="BillboardGui와 그 위에 떠 있는 화면 콘솔을 설명하는 TextLabel입니다." />

전광판의 `Class.BillboardGui.Size|Size` 속성은 `Class.GuiObject.Size`와 약간 다르게 작동합니다. **오프셋** 컴포넌트는 동일하게 작동하지만, **스케일** 컴포넌트는 3D 공간에서 스터드 크기로 사용됩니다.

`Class.TextLabel`을 포함하는 크기 조정된 `Class.BillboardGui`를 만들 때, 카메라 거리 변화에 따라 텍스트가 전광판 캔버스와 함께 조정되도록 라벨의 `Class.TextLabel.TextScaled|TextScaled` 속성을 활성화하는 것이 유용합니다.

`Class.BillboardGui` 내부의 `Class.ImageButton|ImageButtons` 및 `Class.TextButton|TextButtons`와 같은 대화형 UI 요소는 일반적으로 `Class.BillboardGui`를 `Class.StarterGui` 내에 배치하여 `Class.PlayerGui`에 부모로 설정되어야만 사용자 입력을 받을 수 있습니다. `Class.BillboardGui.Adornee|Adornee` 속성을 사용하여 3D 세계의 부품이나 부착물을 타겟팅할 수 있으며, `Class.BillboardGui` 자체는 `Class.PlayerGui`에 남아 있습니다.

`Class.BillboardGui` 컨테이너를 사용하는 방법에 대한 가이드는 [In-Experience UI](/ui/in-experience-containers#billboard-ui)에서 확인하세요.

##### 캐싱 동작

성능 향상을 돕기 위해 `Class.BillboardGui`의 표현은 아래 사항 중 하나가 발생할 때까지 캐싱되며, 그 이후 다음 렌더링 프레임에서 표현이 재계산됩니다.

- `Class.BillboardGui`에 자손이 추가되거나 제거됩니다.
- `Class.BillboardGui`의 자손 속성 중 하나가 변경됩니다.
- `Class.BillboardGui` 자체의 속성이 변경됩니다.


BillboardGui

자손이 입력 이벤트를 받을지 여부를 제어합니다. 만약 `Class.BillboardGui`가 `Class.GuiButton`을 포함하고 있다면, 그 버튼은 `Class.BillboardGui.Active|Active`가 `true`로 설정된 경우에만 클릭 가능해집니다.

`Class.BillboardGui` 내부의 `Class.ImageButton|ImageButtons` 및 `Class.TextButton|TextButtons`와 같은 대화형 UI 요소는 `Class.PlayerGui`에 부모로 설정되어 있어야 사용자 입력을 받을 수 있으며, 일반적으로 `Class.BillboardGui`를 `Class.StarterGui`내에 배치해야 합니다. `Class.BillboardGui.Adornee|Adornee` 속성을 사용하여 `Class.Workspace`의 `Class.BasePart` 또는 `Class.Attachment`에 `Class.BillboardGui`를 첨부할 수 있으며, 부모로 설정할 필요는 없습니다.


BillboardGui.Active

자손이 입력 이벤트를 받을지 여부를 제어합니다.


`Class.BillboardGui`가 상대적으로 위치하는 목표 `Class.BasePart` 또는 `Class.Attachment`를 설정하여 부모 부품이나 부착물을 재정의합니다.


BillboardGui.Adornee

`Class.BillboardGui`가 상대적으로 위치하는 목표 부품 또는 부착물을 설정합니다.


이 속성은 `Class.BillboardGui`가 항상 다른 3D 객체 위에 렌더링될 것인지 결정합니다.

`false`로 설정되었을 때(기본값) `Class.BillboardGui`는 다른 3D 콘텐츠처럼 렌더링되며 다른 3D 객체에 가려집니다. `true`로 설정되면 `Class.BillboardGui`는 항상 3D 콘텐츠 위에 렌더링되며 표현이 크게 변경됩니다:

- 색상은 `Class.ScreenGui` 내에서 보이는 방식과 동일하게 나타납니다.
- 텍스트는 고 DPI 장치에서 더 선명하게 나타날 수 있습니다.
- `Class.BillboardGui.LightInfluence|LightInfluence`는 `0`인 것처럼 처리됩니다.
- `Class.BillboardGui.Brightness|Brightness`는 영향을 미치지 않습니다.


BillboardGui.AlwaysOnTop

`Class.BillboardGui`가 다른 3D 객체 위에 항상 렌더링될 것인지 여부를 결정합니다.


이 속성은 `Class.BillboardGui` 컨테이너의 빛이 스케일되는 수치를 결정합니다.
`Class.BillboardGui.LightInfluence|LightInfluence`가 `0`일 때. 기본적으로 이 속성은 `1`로 설정되어 있으며 `0`에서 `1000`사이의 숫자로 설정할 수 있습니다.
이 속성을 수정하면 `Class.BillboardGui`의 겉보기 밝기를 환경에 더 잘 맞출 수 있습니다. 예를 들어, 비디오 전광판을 어두운 방 안에서 밝게 하려면 `Class.BillboardGui.Brightness|Brightness`를 `10`으로 증가시킬 수 있습니다.

`Class.BillboardGui.Brightness|Brightness`는 스튜디오에서는 접근할 수 없으며, `Class.BillboardGui.LightInfluence|LightInfluence`가 `1`이거나 `Class.BillboardGui.AlwaysOnTop|AlwaysOnTop`가 `true`인 경우에는 영향을 주지 않습니다.


BillboardGui.Brightness

`Class.BillboardGui.LightInfluence|LightInfluence`가 `0`인 경우 전광판 컨테이너의 빛이 스케일되는 수치를 결정합니다.


`true`로 설정되면(기본값) `Class.BillboardGui` 캔버스 경계 밖에 떨어진 `Class.GuiObject|GuiObjects`는 그려지지 않습니다.

이 속성이 `false`일 때도, 캔버스를 완전히 벗어난 `Class.GuiObject|GuiObjects`는 렌더링되지 않습니다.


BillboardGui.ClipsDescendants

`Class.GuiObject|GuiObjects`의 일부가 `Class.BillboardGui` 캔버스 경계 밖에 떨어질 경우 이를 그릴지 여부를 결정합니다.


`Class.BillboardGui`와 플레이어의 카메라 간의 현재 거리(스터드 단위)입니다. 이 속성의 값이 변경되면 이벤트가 발생하지 않으며, `Class.BillboardGui.DistanceStep|DistanceStep`가 `0`보다 커야 합니다.


BillboardGui.CurrentDistance

`Class.BillboardGui`와 플레이어의 카메라 간의 현재 거리(스터드 단위)입니다.


`Class.BillboardGui`가 플레이어의 현재 카메라에 따라 더 이상 크기가 증가하지 않을 거리(스터드 단위)를 결정하며 기본값은 `0`입니다. 만약 `Class.BillboardGui.CurrentDistance|CurrentDistance`가 이 값보다 작다면 이 거리에서 더 이상 커지지 않습니다.


BillboardGui.DistanceLowerLimit

`Class.BillboardGui`가 크기가 더 이상 증가하지 않을 거리(스터드 단위)를 결정합니다.


플레이어의 카메라가 `Class.BillboardGui`에 가까워지거나 멀어질 때, `Class.BillboardGui.CurrentDistance|CurrentDistance`의 크기를 결정하는 증감(스터드 단위)입니다. 속성의 기본값은 `0`입니다.


BillboardGui.DistanceStep

플레이어의 카메라가 `Class.BillboardGui`에 가까워지거나 멀어질 때, `Class.BillboardGui.CurrentDistance|CurrentDistance`의 크기를 결정하는 증감(스터드 단위)입니다.


`Class.BillboardGui`가 플레이어의 현재 카메라에 따라 더 이상 크기가 줄어들지 않을 거리(스터드 단위)를 결정합니다. 만약 `Class.BillboardGui.CurrentDistance|CurrentDistance`가 이 값보다 크다면 이 거리에서 더 이상 작아지지 않습니다.

이 속성은 값이 `0`보다 작을 경우 무시됩니다. 기본값은 `-1`이며, 이는 기본적으로 속성이 무시된다는 의미입니다.


BillboardGui.DistanceUpperLimit

`Class.BillboardGui`가 크기가 더 이상 줄어들지 않을 거리(스터드 단위)를 결정합니다.


이 속성은 `Class.BillboardGui`가 자신의 `Class.BillboardGui.Adornee|Adornee`로부터 얼마나 오프셋 되는지를 결정하며, `Class.Camera` 방향에 상대적입니다. 모델의 `Class.Camera`에 맞춰 정렬된 경계 상자의 절반 크기 단위로 설정됩니다.

`Class.BillboardGui.StudsOffset|StudsOffset`와 유사하게 작동하지만 스터드 단위를 사용하는 속성이며,
`Class.BillboardGui.ExtentsOffsetWorldSpace|ExtentsOffsetWorldSpace`는 오프셋 방향이 전역 축에 상대적입니다.


BillboardGui.ExtentsOffset

`Class.BillboardGui`가 자신의 `Class.BillboardGui.Adornee|Adornee`로부터 얼마나 오프셋 되는지를 결정하며, `Class.Camera` 방향에 상대적인 스터드 단위로 설정됩니다.


이 속성은 `Class.BillboardGui`가 자신의 `Class.BillboardGui.Adornee|Adornee`로부터 얼마나 오프셋 되는지를 결정하며, 전역 축에 상대적으로 설정됩니다. 모델의 축에 맞춰 정렬된 경계 상자의 절반 크기 단위로 설정됩니다.

`Class.BillboardGui.StudsOffset|StudsOffset`와 유사하게 작동하지만 스터드 단위를 사용하는 속성이며,
`Class.BillboardGui.ExtentsOffset|ExtentsOffset`는 오프셋 방향이 `Class.Camera`에 상대적입니다.


BillboardGui.ExtentsOffsetWorldSpace

`Class.BillboardGui`가 자신의 `Class.BillboardGui.Adornee|Adornee`로부터 얼마나 오프셋 되는지를 결정하며, 전역 축에 상대적인 절반 크기 단위로 설정됩니다.


전환경 조명에 의해 `Class.BillboardGui`가 얼마나 영향을 받는지를 제어하며, 범위는 `0`부터 `1`까지입니다. 이를 `1`로 설정하면 주변 조명이 모양에 완전히 영향을 미치고, `0`으로 설정하면 조명이 아무 영향을 미치지 않습니다.


BillboardGui.LightInfluence

전환경 조명에 의해 `Class.BillboardGui`가 얼마나 영향을 받는지를 제어합니다.


이 속성은 카메라로부터 얼마나 떨어져 있으면 `Class.BillboardGui`가 렌더링을 멈추는지를 제어합니다. `0` 또는 `inf` (기본값)는 제한이 없음을 의미하며, 무한히 멀리서도 렌더링됩니다.

야외에서 나타나는 `Class.BillboardGui|BillboardGuis`의 경우, 전광판의 UI가 나타나거나 사라질 때 화면에서 충분히 작게 보이도록 하기 위해 `Class.BillboardGui.MaxDistance|MaxDistance`가 충분히 높아야 합니다.


BillboardGui.MaxDistance

`Class.BillboardGui`가 렌더링을 멈추기 전에 얼마나 멀리 떨어져 있어야 하는지를 제어합니다.


특정 플레이어로부터 `Class.BillboardGui`를 숨기기 위해 스크립트에서 사용됩니다.

`Class.BillboardGui`를 여러 플레이어로부터 숨기려면, 이 전광판을 `Class.StarterGui`에 배치하고 스크립트를 사용하여 `Class.BillboardGui.Enabled|Enabled` 속성을 `Class.Players.LocalPlayer|LocalPlayer`가 볼 수 있어야 하는지에 따라 설정합니다. `Class.BillboardGui.Adornee|Adornee` 속성을 사용하여 `Class.Workspace`의 `Class.BasePart` 또는 `Class.Attachment`에 `Class.BillboardGui`를 첨부할 수 있습니다. 이 방법으로 부모로 설정할 필요는 없습니다.


BillboardGui.PlayerToHideFrom

특정 플레이어로부터 `Class.BillboardGui`를 숨기기 위해 스크립트에서 사용됩니다.


`Class.BillboardGui`의 화면에서 크기를 제어합니다. `Class.GuiObject.Size`와는 달리, 이 속성의 [스케일](/ui/position-and-size#size) 컴포넌트는 3D 공간에서 전광판의 스터드 크기를 설정합니다.


BillboardGui.Size

화면에서 `Class.BillboardGui`의 크기를 제어합니다.


앵커 포인트처럼 작용하는 크기 상대 단위의 2D 오프셋입니다. 이는 `Class.GuiObject.AnchorPoint` 속성과 유사하게 사용할 수 있지만, 값이 다릅니다.

<table size="small">
<thead>
<th>크기 오프셋</th>
<th>설명</th>
</thead>
<tbody>
<tr>
<td><code>0, 0</code></td>
<td>UI가 중앙에 고정됩니다.</td>
</tr>
<tr>
<td><code>0.5, 0.5</code></td>
<td>UI가 왼쪽 아래에 고정됩니다.</td>
</tr>
<tr>
<td><code>0.5, -0.5</code></td>
<td>UI가 왼쪽 위에 고정됩니다.</td>
</tr>
<tr>
<td><code>-0.5, 0.5</code></td>
<td>UI가 오른쪽 위에 고정됩니다.</td>
</tr>
<tr>
<td><code>-0.5, -0.5</code></td>
<td>UI가 오른쪽 아래에 고정됩니다.</td>
</tr>
</tbody>
</table>

`Class.BillboardGui.StudsOffset|StudsOffset`, `Class.BillboardGui.StudsOffsetWorldSpace|StudsOffsetWorldSpace`, `Class.BillboardGui.ExtentsOffset|ExtentsOffset`, `Class.BillboardGui.ExtentsOffsetWorldSpace|ExtentsOffsetWorldSpace`와 같은 3D 공간에서 작동하는 오프셋 속성과 유사한 기능을 합니다.


BillboardGui.SizeOffset

앵커 포인트처럼 작용하는 크기 상대 단위의 2D 오프셋입니다.


이 속성은 `Class.BillboardGui`가 자신의 `Class.BillboardGui.Adornee|Adornee`로부터 스터드 단위로 얼마나 오프셋 되는지를 결정하며, `Class.Camera` 방향에 상대적입니다.

전역 축에 상대적으로 오프셋 방향이 설정된 `Class.BillboardGui.StudsOffsetWorldSpace|StudsOffsetWorldSpace`와 유사하게 작동합니다.


BillboardGui.StudsOffset

`Class.BillboardGui`가 자신의 `Class.BillboardGui.Adornee|Adornee`로부터 스터드 단위로 얼마나 오프셋 되는지를 결정하며, `Class.Camera` 방향에 상대적입니다.


이 속성은 `Class.BillboardGui`가 자신의 `Class.BillboardGui.Adornee|Adornee`로부터 전역 축에 상대적으로 얼마나 오프셋 되는지를 결정합니다.

`Class.BillboardGui.StudsOffset|StudsOffset`와 유사하며 오프셋 방향이 `Class.Camera`에 상대적입니다.


BillboardGui.StudsOffsetWorldSpace

`Class.BillboardGui`가 자신의 `Class.BillboardGui.Adornee|Adornee`로부터 전역 축에 상대적으로 얼마나 오프셋 되는지를 결정합니다.


`Class.GuiObject|GuiObjects`의 컨테이너로, 카메라를 향해 3D 공간에서 렌더링됩니다.


**LayerCollector**는 `Class.ScreenGui`와 같은 `Class.GuiObject` 자손을 렌더링하는 2D UI 컨테이너의 기본 클래스입니다.

성능 개선을 위해 `Class.LayerCollector`의 외관은 다음 사건 중 하나가 발생할 때까지 캐시됩니다:

- 자손이 추가되거나 제거됨.
- 자손의 속성이 변경됨.
- `Class.LayerCollector` 자체의 속성이 변경됨.

LayerCollector:GetLayoutNodeTree

LayerCollector

이 `Class.LayerCollector`의 가시성을 전환합니다. `false`일 경우, UI 내용은 렌더링되지 않으며, 사용자 입력을 처리하거나 변경 사항에 따라 업데이트되지 않습니다.

LayerCollector.Enabled

이 `Class.LayerCollector`의 가시성을 전환합니다.

`false`로 설정되면 이 `Class.LayerCollector`가 `Class.StarterGui`의 직접 자식일 경우, 각 플레이어의 `Class.PlayerGui`에 한 번만 복제되며, 플레이어의 캐릭터가 재생성될 때 삭제되지 않습니다.

`true`로 설정되면(기본값) 또는 이 `Class.LayerCollector`가 `Class.StarterGui`의 **간접** 자손인 경우, 플레이어의 캐릭터가 재생성될 때마다 각 플레이어의 `Class.PlayerGui`에 복제되며, 플레이어 캐릭터가 다시 재생성될 때 스스로를 삭제합니다.

LayerCollector.ResetOnSpawn

`Class.LayerCollector`가 플레이어의 캐릭터가 재생성될 때마다(스스로를 삭제하고 플레이어의 `Class.PlayerGui`에 다시 복제함) 리셋되는지 여부를 결정합니다.

`Class.GuiObject.ZIndex`가 이 `Class.LayerCollector`의 모든 자식에서 어떻게 동작하는지를 제어합니다.

`Enum.ZIndexBehavior.Sibling`(기본값)에서는 자식이 항상 부모 위에 렌더링되며, `Class.GuiObject.ZIndex|ZIndex`가 단일 UI 객체의 자식들이 서로 렌더링되는 순서를 결정하는 데 사용됩니다.

`Enum.ZIndexBehavior.Global`은 모든 자식을 `Class.GuiObject.ZIndex|ZIndex`에 따라 정렬한 다음, 계층 순서를 사용하여 동점을 해결합니다. 결과적으로, `Class.GuiObject`의 자식은 부모보다 최소한 같은 높이의 `Class.GuiObject.ZIndex|ZIndex` 값을 가져야 하며, 그렇지 않으면 부모 아래에 렌더링됩니다.


LayerCollector.ZIndexBehavior

`Class.GuiObject.ZIndex`가 이 `Class.LayerCollector`의 모든 자식에서 어떻게 동작하는지를 제어합니다.


2D UI 컨테이너의 기본 클래스이며, `Class.GuiObject|GuiObjects`를 계층으로 렌더링합니다.

`Class.GuiBase2d`는 2D
`Class.GuiObject|GuiObjects`에서 상속된 추상 클래스입니다.


이 이벤트는 게임패드 선택이 연결된 `Class.GuiBase2d` 또는 그 자손 `Class.GuiObject|GuiObjects` 내에서 이동하거나 떠나거나 변경될 때 발생합니다. 선택 강조가 `Class.GuiObject`로 이동할 때, 이벤트는 해당 `Class.GuiObject`에서 모든 조상으로 전파되어 선택이 변경/진입/퇴장했음을 알립니다.


GuiBase2d.SelectionChanged

amISelected

새로운 선택이 연결된 GuiBase2d와 일치하면 true입니다.


previousSelection

선택이 변경되기 전에 이전에 선택된 `Class.GuiObject` 또는 선택된 것이 없으면 nil입니다.


newSelection

선택이 변경된 후 현재 선택된 `Class.GuiObject` 또는 선택된 것이 없으면 nil입니다.


게임패드 선택이 연결된 `Class.GuiBase2d` 또는 그 자손 `Class.GuiObject|GuiObjects` 내에서 이동하거나 떠나거나 변경될 때 발생합니다.


GuiBase2d

`Class.GuiBase2d.AbsolutePosition|AbsolutePosition`은 `Class.GuiBase2d` 요소의 화면 위치를 픽셀 단위로 제공하는 읽기 전용 속성입니다. 이는 요소가 조상들의 크기와 위치로 인해 렌더링되는 실제 픽셀 위치를 나타냅니다. `Class.GuiBase2d.AbsolutePosition|AbsolutePosition`은 항상 `Class.GuiBase2d` 요소의 왼쪽 상단 모서리를 나타냅니다.

`Class.GuiBase2d`가 `Class.ScreenGui`에 있을 경우, `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` 속성은 `Enum.ScreenInsets|CoreUISafeInsets` 뷰포트 좌표 시스템을 사용합니다. 이 좌표 시스템의 원점은 Roblox 상단 바의 왼쪽 하단 모서리에 위치합니다. 이는 `Class.InputObject.Position` 속성이 사용하는 동일한 좌표 시스템입니다.

<img src="/assets/engine-api/classes/GuiBase2d/AbsolutePositionCoordinateSystem.png" width="840" alt="AbsolutePosition 좌표 시스템의 원점을 보여주는 다이어그램입니다." />

또한 `Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation` 및 `Class.GuiBase2d.AbsoluteSize|AbsoluteSize`를 참조하십시오.


GuiBase2d.AbsolutePosition

`Class.GuiBase2d` 요소의 실제 화면 위치를 픽셀 단위로 설명합니다.


`Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation`은 `Class.GuiBase2d` 요소의 실제 화면 회전을 도 단위로 설명하는 읽기 전용 속성입니다. 이 속성은 **경계 검사**를 수행하지 않으므로 값이 `0`에서 `360` 범위에 있지 않을 수 있습니다.

또한 `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` 및 `Class.GuiBase2d.AbsoluteSize|AbsoluteSize`를 참조하십시오.


GuiBase2d.AbsoluteRotation

`Class.GuiBase2d` 요소의 실제 화면 회전을 도 단위로 설명합니다.


`Class.GuiBase2d.AbsoluteSize|AbsoluteSize`는 `Class.GuiBase2d` 요소의 실제 화면 크기를 픽셀 단위로 설명하는 읽기 전용 속성입니다.

또한 `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` 및 `Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation`를 참조하십시오.


GuiBase2d.AbsoluteSize

`Class.GuiBase2d` 요소의 실제 화면 크기를 픽셀 단위로 설명합니다.


`true`로 설정하면 이 `Class.GuiBase2d`와 그 자손에 로컬라이제이션이 적용됩니다. 로컬라이제이션에 사용되는 항목은 `Class.LocalizationService:GetTableEntries()`에서 반환된 동일한 항목 집합입니다. `Class.GuiBase2d.AutoLocalize|AutoLocalize`가 활성화된 항목은 클라우드 테이블이 로드된 후 필요에 따라 자동으로 다시 번역됩니다.

또한 `Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable`을 참조하십시오.


GuiBase2d.AutoLocalize

`true`로 설정하면 이 `Class.GuiBase2d`와 그 자손에 로컬라이제이션이 적용됩니다.


이 속성은 로컬라이제이션 테이블의 `Class.LocalizationTable.Root`가 이 객체 또는 이 객체의 조상을 대상으로 할 때 자동으로 true로 설정됩니다. `Class.LocalizationTable|LocalizationTables`의 `Class.LocalizationTable.Root` 속성이 인스턴스를 가리키면 루트 인스턴스의 모든 `Class.TextLabel.TextButton`이 로컬라이즈됩니다.


GuiBase2d.Localize

로컬라이제이션 테이블의 `Class.LocalizationTable.Root`가 이 객체 또는 이 객체의 조상을 대상으로 할 때 자동으로 true로 설정됩니다.


이 `Class.GuiBase2d`와 그 자손에 자동 로컬라이제이션을 적용하는 데 사용될 `Class.LocalizationTable`에 대한 참조입니다.
`Class.GuiBase2d.AutoLocalize|AutoLocalize`는 자동 로컬라이제이션이 적용되도록 `Class.GuiBase2d`와 그 조상에 대해 `true`로 설정되어야 합니다.

이것을 `Class.DataModel`의 어디에서나 `Class.LocalizationTable`을 참조하도록 설정할 수 있습니다. `Class.GuiBase2d` 객체와 그 모든 자식은 해당 특정 `Class.LocalizationTable`과 그 조상을 사용하여 자동 텍스트 교체를 시도하며, 그 후에 정의되지 않은 순서로 `Class.LocalizationService` 아래의 테이블과 클라우드 테이블을 사용합니다.

참조된 테이블에 번역이 없으면, 해당 테이블의 부모에서 번역을 찾고, 그 부모가 또한 `Class.LocalizationTable`인 경우 계속해서 찾습니다.

자동 로컬라이제이션에 사용되는 `Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable`에 대해 설명하는 `Class.LocalizationService:GetTableEntries()`도 참조하십시오.


GuiBase2d.RootLocalizationTable

이 `Class.GuiBase2d`와 그 자손에 자동 로컬라이제이션을 적용하는 데 사용될 `Class.LocalizationTable`에 대한 참조입니다.


`Class.GuiBase2d.SelectionBehaviorDown|SelectionBehaviorDown`은 선택 그룹에서 아래 방향으로 게임패드 선택이 이동하는 방식을 사용자 정의합니다. 이 속성은 `Class.GuiBase2d.SelectionGroup|SelectionGroup`가 `true`일 때만 효과가 있습니다; 기본적으로 `SelectionGroup`는 `false`이며, 이 속성이 `false`인 동안에는 아무 효과도 없습니다.

기본값은 `Enum.SelectionBehavior.Escape`로, 선택 그룹 내의 버튼을 우선시하지만, 내부에 적합한 버튼이 없을 경우 선택 그룹 외부의 `Class.GuiObject`로 아래 방향으로 이동할 수 있습니다. 대신 `Enum.SelectionBehavior.Stop`으로 설정하면 선택이 그룹에 제한되어 그룹 외부로 아래 방향으로 이동하지 못하게 됩니다.

또한 `Class.GuiBase2d.SelectionGroup|SelectionGroup`을 참조하십시오.


GuiBase2d.SelectionBehaviorDown

게임패드 선택 동작을 아래 방향으로 사용자 정의합니다.


`Class.GuiBase2d.SelectionBehaviorLeft|SelectionBehaviorLeft`는 선택 그룹에서 왼쪽 방향으로 게임패드 선택이 이동하는 방식을 사용자 정의합니다. 이 속성은 `Class.GuiBase2d.SelectionGroup|SelectionGroup`가 `true`일 때만 효과가 있습니다; 기본적으로 `SelectionGroup`는 `false`이며, 이 속성이 `false`인 동안에는 아무 효과도 없습니다.

기본값은 `Enum.SelectionBehavior.Escape`로, 선택 그룹 내의 버튼을 우선시하지만, 내부에 적합한 버튼이 없을 경우 선택 그룹 외부의 `Class.GuiObject`로 왼쪽 방향으로 이동할 수 있습니다. 대신 `Enum.SelectionBehavior.Stop`으로 설정하면 선택이 그룹에 제한되어 그룹 외부로 왼쪽 방향으로 이동하지 못하게 됩니다.

또한 `Class.GuiBase2d.SelectionGroup|SelectionGroup`을 참조하십시오.


GuiBase2d.SelectionBehaviorLeft

게임패드 선택 동작을 왼쪽 방향으로 사용자 정의합니다.


`Class.GuiBase2d.SelectionBehaviorRight|SelectionBehaviorRight`는 선택 그룹에서 오른쪽 방향으로 게임패드 선택이 이동하는 방식을 사용자 정의합니다. 이 속성은 `Class.GuiBase2d.SelectionGroup|SelectionGroup`가 `true`일 때만 효과가 있습니다; 기본적으로 `SelectionGroup`는 `false`이며, 이 속성이 `false`인 동안에는 아무 효과도 없습니다.

기본값은 `Enum.SelectionBehavior.Escape`로, 선택 그룹 내의 버튼을 우선시하지만, 내부에 적합한 버튼이 없을 경우 선택 그룹 외부의 `Class.GuiObject`로 오른쪽 방향으로 이동할 수 있습니다. 대신 `Enum.SelectionBehavior.Stop`으로 설정하면 선택이 그룹에 제한되어 그룹 외부로 오른쪽 방향으로 이동하지 못하게 됩니다.

또한 `Class.GuiBase2d.SelectionGroup|SelectionGroup`을 참조하십시오.


GuiBase2d.SelectionBehaviorRight

게임패드 선택 동작을 오른쪽 방향으로 사용자 정의합니다.


`Class.GuiBase2d.SelectionBehaviorUp|SelectionBehaviorUp`는 선택 그룹에서 위쪽 방향으로 게임패드 선택이 이동하는 방식을 사용자 정의합니다. 이 속성은 `Class.GuiBase2d.SelectionGroup|SelectionGroup`가 `true`일 때만 효과가 있습니다; 기본적으로 `SelectionGroup`는 `false`이며, 이 속성이 `false`인 동안에는 아무 효과도 없습니다.

기본값은 `Enum.SelectionBehavior.Escape`로, 선택 그룹 내의 버튼을 우선시하지만, 내부에 적합한 버튼이 없을 경우 선택 그룹 외부의 `Class.GuiObject`로 위쪽 방향으로 이동할 수 있습니다. 대신 `Enum.SelectionBehavior.Stop`으로 설정하면 선택이 그룹에 제한되어 그룹 외부로 위쪽 방향으로 이동하지 못하게 됩니다.

또한 `Class.GuiBase2d.SelectionGroup|SelectionGroup`을 참조하십시오.


GuiBase2d.SelectionBehaviorUp

게임패드 선택 동작을 위쪽 방향으로 사용자 정의합니다.


게임패드 선택이 버튼 간에 이동하는 방식, 그룹을 떠나는 방식, 다른 버튼을 선택하는 방식을 사용자 정의할 수 있습니다.

`Class.GuiBase2d.SelectionGroup|SelectionGroup`를 `true`로 설정하면 `Class.GuiBase2d.SelectionBehaviorUp|SelectionBehaviorUp`, `Class.GuiBase2d.SelectionBehaviorDown|SelectionBehaviorDown`, `Class.GuiBase2d.SelectionBehaviorLeft|SelectionBehaviorLeft`, 및 `Class.GuiBase2d.SelectionBehaviorRight|SelectionBehaviorRight` 속성이 노출됩니다. 이러한 선택 동작의 경우, `Enum.SelectionBehavior.Escape`(기본값) 설정은 게임패드 선택이 먼저 선택 그룹 내에서 선택을 찾으려고 시도하고 적합한 버튼을 찾지 못할 경우에만 외부로 이동하도록 합니다. 반면에 `Enum.SelectionBehavior.Stop` 설정은 게임패드 선택이 선택 그룹 내에서만 찾고 선택 동작 방향에서 그룹 외부로 이동하지 않도록 합니다.


GuiBase2d.SelectionGroup

게임패드 선택 이동을 사용자 정의할 수 있습니다.


2D `Class.GuiObject|GuiObjects`에서 상속된 추상 클래스입니다.


GuiBase는 대부분의 그래픽 사용자 인터페이스 객체가 상속하는 추상 클래스입니다.


GuiBase

`Instance`는 Roblox 클래스 계층의 모든 클래스의 기본 클래스입니다
`Class.DataModel` 트리의 일부가 될 수 있습니다.

루트 `Instance` 객체를 직접 생성하는 것은 불가능하지만, 특별한
`Datatype.Instance.new()` 생성자는 코드로 객체를 생성하며,
클래스의 이름을 매개변수로 받아 생성된 객체를 반환합니다.


인스턴스의 조상을 변경하는 것을 감지하기 위해 `Class.Instance.AncestryChanged` 이벤트에 연결하는 방법을 보여줍니다.

ChangingPart의 부모는 시간이 지남에 따라 다른 값으로 설정됩니다. 파트의 부모는 파트의 조상이므로, `Class.Instance.AncestryChanged` 이벤트는 변경될 때마다 발생합니다.

이 인스턴스가 재부모화되거나 그 조상 중 하나가 재부모화될 때 발생합니다.

이 이벤트를 사용하여 스튜디오에서 인스턴스의 삭제를 추적할 수 있습니다. 예를 들어 탐색기에서 수동으로 삭제하거나 플러그인을 통해 삭제하는 경우입니다. `Class.Instance:Destroy()`를 사용하여 인스턴스가 파괴될 때를 감지해야 하는 경우, 대신 `Class.Instance.Destroying` 이벤트를 사용하세요.


Instance.AncestryChanged

child

`Class.Instance.Parent|Parent` 속성이 변경된 인스턴스입니다. 이 인스턴스 또는 더 먼 조상이 될 수 있으며, 반드시 핸들러가 연결된 인스턴스일 필요는 없습니다.


parent

`child` 매개변수의 새로운 부모입니다.


이 객체 또는 그 조상의 `Class.Instance.Parent` 속성이 변경될 때 발생합니다.


이 이벤트는 인스턴스에서 속성이 변경될 때마다 발생하며, 속성이 `nil`로 설정될 때도 포함됩니다. 변경된 속성의 이름이 연결된 함수에 전달됩니다.

예를 들어, 다음 코드 조각은 파트의 속성 중 하나가 변경될 때마다 `attributeChanged()` 함수를 연결합니다:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "changed")
end

part.AttributeChanged:Connect(attributeChanged)
```
특정 속성이 변경될 때 발생하는 이벤트를 반환하는 `Class.Instance:GetAttributeChangedSignal()`도 참조하세요.


Instance.AttributeChanged

attribute

인스턴스에서 속성이 변경될 때마다 발생합니다.


이 코드 조각은 객체가 Workspace에 추가될 때 그 이름을 출력합니다:


이 `Class.Instance`에 자식이 추가된 후 발생합니다.

클라이언트에서 서버가 생성한 객체를 감지하기 위해 이 메서드를 사용할 때는, 이러한 객체의 자손을 인덱싱할 때 `Class.Instance:WaitForChild()`를 사용하는 것이 필요합니다. 이는 객체와 그 자손이 서버에서 클라이언트로 동시에 복제될 것이라는 보장이 없기 때문입니다. 예를 들어:

```
local Workspace = game:GetService("Workspace")

Workspace.ChildAdded:Connect(function(child)
	-- 자손이 아직 복제되지 않았을 수 있으므로 WaitForChild()를 사용하세요
	local head = child:WaitForChild("Head")
end)
```
이 이벤트는 `Class.Instance`의 즉각적인 자식에 대해서만 작동합니다. 모든 자손을 캡처하는 이벤트가 필요하다면 `Class.Instance.DescendantAdded`를 사용하세요.

`Class.Instance.ChildRemoved`도 참조하세요.


Instance.ChildAdded

이 `Class.Instance`에 자식이 추가된 후 발생합니다.


Instance.childAdded

이 코드 조각은 객체가 작업 공간에서 제거될 때 그 이름을 출력합니다:


이 `Class.Instance`에서 자식이 제거된 후 발생합니다.

제거된 것은 객체의 부모가 이 `Class.Instance`에서 이 `Class.Instance`가 아닌 다른 것으로 변경된 경우를 의미합니다. 이 이벤트는 자식이 파괴될 때도 발생합니다(`Class.Instance:Destroy()` 사용) 파괴 함수가 객체의 부모를 `nil`로 설정하기 때문입니다.

이 이벤트는 `Class.Instance`의 즉각적인 자식에 대해서만 작동합니다. 모든 자손을 캡처하는 이벤트가 필요하다면 `Class.Instance.DescendantRemoving`을 사용하세요.

`Class.Instance.ChildAdded`도 참조하세요.


Instance.ChildRemoved

이 `Class.Instance`에서 자식이 제거된 후 발생합니다.


다음 예제는 Workspace에 추가되는 모든 객체의 이름을 출력합니다:

이 이벤트는 자손이 이 `Class.Instance`에 추가된 후 발생합니다.

모든 자손에 대해 발생하므로, 객체를 `Class.Instance`에 부모로 설정하면 이 객체와 모든 자손에 대해 개별적으로 이벤트가 발생합니다.

`Class.Instance`의 **직접 자식**에만 관심이 있다면, 대신 `Class.Instance.ChildAdded`를 사용하세요.

`Class.Instance.DescendantRemoving`도 참조하세요.


Instance.DescendantAdded

descendant

자손이 이 `Class.Instance`에 추가된 후 발생합니다.


다음 예제는 Workspace에서 제거되는 하위 항목의 이름을 출력합니다:

이 이벤트는 **직접적으로** 부모 `Class.Instance`가 변경되어 **자손** 인스턴스가 더 이상 자손이 되지 않도록 할 때 발생합니다. `Class.Instance:Destroy()|Destroy()`는 인스턴스의 `Class.Instance.Parent|Parent`를 `nil`로 변경하므로, 부모의 자손에 대해 이 메서드를 호출하면 이 이벤트가 발생합니다.

이 이벤트가 발생할 때 자손의 부모는 변경되지 않습니다. 만약 자손이 부모의 **직접 자식**인 경우, 이 이벤트는 `Class.Instance.ChildRemoved`보다 먼저 발생합니다.

자손이 자식을 가지고 있는 경우, 이 이벤트는 자손을 먼저 발생시키고, 그 다음에 자손을 발생시킵니다.

#### 경고

이 이벤트는 제거되는 자손 객체와 함께 발생합니다. 자손의 `Class.Instance.Parent|Parent`를 다른 것으로 설정하려고 하면 실패합니다. 아래는 이를 보여주는 예입니다:

```
local Workspace = game:GetService("Workspace")

Workspace.DescendantRemoving:Connect(function(descendant)
	-- 이 함수에서 자손의 부모를 조작하지 마세요!
	-- 이 이벤트는 부모가 조작되었기 때문에 발생하며, 변경이 아직 발생하지 않았습니다
	-- 따라서 이렇게 부모를 변경하는 것은 문제가 됩니다:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```

`Class.Instance.DescendantAdded|DescendantAdded`도 참조하세요.


Instance.DescendantRemoving

이 `Class.Instance`의 자손이 제거되기 직전에 발생합니다.


이 샘플은 즉시 신호 동작을 사용할 때 인스턴스가 파괴되더라도 연결된 함수가 yield될 때까지 그대로 유지된다는 것을 보여줍니다.

이 샘플은 Deferred 신호 동작을 사용할 때, 인스턴스가 신호가 발생하기 전에 어떻게 파괴되는지를 보여줍니다.

연결된 함수가 여전히 사용 중인 동안 `Class.Instance`는 메모리에서 삭제되지 않습니다. 그러나 함수가 어느 시점에서든 대기하면, `Class.Instance`와 그 자손은 `nil`로 부모가 설정됩니다.

`Class.Workspace.SignalBehavior` 속성이 `Enum.SignalBehavior.Immediate`로 설정된 경우, 이 이벤트는 `Class.Instance` 또는 그 조상이 `Class.Instance:Destroy()`로 파괴되기 직전에 발생합니다.

`Class.Workspace.SignalBehavior` 속성이 `Enum.SignalBehavior.Deferred`로 설정된 경우, 이 이벤트는 다음 재개 지점에서 발생하며, 이는 `Class.Instance` 또는 그 조상이 `Class.Instance:Destroy()`로 파괴된 후입니다.

`Enum.SignalBehavior.Deferred|Deferred` 동작에서는 스크립트를 자신의 `Class.Instance.Destroying` 이벤트에 연결하는 것이 문제가 됩니다. 스크립트가 콜백이 호출되기 전에 파괴되기 때문입니다(즉, 실행되지 않습니다).

스튜디오에서 `Class.Instance`를 삭제할 때, 예를 들어 [탐색기](/studio/explorer)를 통해 수동으로 삭제하거나 플러그인을 통해 삭제할 때, `Class.Instance`는 파괴되지 않습니다. 대신 부모가 `nil`로 설정되며, 이는 `Class.Instance.AncestryChanged`로 추적할 수 있습니다.


Instance.Destroying

인스턴스가 `Class.Instance:Destroy()`를 통해 파괴되기 직전에 발생합니다.


 `Class.Instance.StyledPropertiesChanged`를 보여줍니다.


이 이벤트는 인스턴스에서 스타일 속성이 변경될 때마다 발생하며, 속성이 `nil`로 설정될 때도 포함됩니다.


Instance.StyledPropertiesChanged

인스턴스에서 스타일 속성이 변경될 때마다 발생하며, 속성이 `nil`로 설정될 때도 포함됩니다.


이 메서드는 인스턴스에 태그를 적용하며, 태그가 이미 적용된 경우에는 효과가 없습니다.
태그를 성공적으로 추가하면 `Class.CollectionService:GetInstanceAddedSignal()`에 의해 생성된 신호가 주어진 태그로 발생합니다.

#### 경고

- 클라이언트 측에서 추가된 인스턴스의 태그는 서버가 나중에 해당 인스턴스에 태그를 추가하거나 제거하면 삭제됩니다.
서버는 모든 태그를 함께 복제하고 이전 태그를 덮어씁니다.

- 인스턴스에 태그를 추가할 때, 태그의 기능을 제공하기 위해 일부 리소스가 사용됩니다.
예를 들어 이벤트 연결 또는 테이블입니다.
메모리 누수를 방지하기 위해 태그가 더 이상 필요하지 않을 때 이를 정리하는 것이 좋습니다(연결 해제, `nil`로 설정 등).
`Class.Instance:RemoveTag()`를 호출하거나 `Class.Instance:Destroy()`를 호출하거나
`Class.CollectionService:GetInstanceRemovedSignal()`에 의해 반환된 신호에 연결된 함수에서 이를 수행하십시오.


Instance:AddTag

인스턴스에 적용할 태그입니다.


인스턴스에 태그를 적용합니다.


자식 함수는 객체의 자식 배열을 반환합니다.


Instance:children

자식 객체/인스턴스의 배열입니다.


객체의 자식 배열을 반환합니다.


이 메서드는 인스턴스의 모든 자식과 자손을 파괴합니다.

```
local part = Instance.new("Part")

-- 반짝임 추가
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

  local sc = Instance.new("Sparkles")
  sc.Parent = sparkles
end

print("Children:", #part:GetChildren())  --> Children: 3

part:ClearAllChildren()

print("Children:", #part:GetChildren())  --> Children: 0
```
모든 자식과 자손을 파괴하고 싶지 않다면,
`Class.Instance:GetChildren()` 또는 `Class.Instance:GetDescendants()`를 사용하여
그 자식/자손을 반복하고 파괴할 대상을 선택하십시오.
예를 들어, 다음 코드 샘플은 `Class.Model`에서 내려오는 모든 `Class.BasePart|BaseParts`를 파괴합니다:

```
local Workspace = game:GetService("Workspace")

local model = Workspace:FindFirstChild("TestModel")

for _, descendant in model:GetDescendants() do
	if descendant:IsA("BasePart") then
		descendant:Destroy()
	end
end
```


Instance:ClearAllChildren

이 메서드는 인스턴스의 모든 자식을 파괴합니다.


 `Class.Instance:Clone()` 를 사용하여 모델을 복제하는 방법을 보여줍니다.

`Clone()`은 인스턴스와 모든 자손의 복사본을 생성하며,
`Class.Instance.Archivable|Archivable`이 아닌 모든 인스턴스는 무시합니다.
루트 인스턴스의 복사본은 이 메서드에 의해 반환되며,
그 `Class.Instance.Parent|Parent`는 `nil`로 설정됩니다.
인스턴스 자체가 `Class.Instance.Archivable|Archivable`가 `false`로 설정되어 있으면,
이 메서드는 `nil`을 반환합니다.

`Class.ObjectValue.Value`와 같은 참조 속성이 복제된 인스턴스에 설정되면,
복사본의 속성 값은 원본의 값에 따라 달라집니다:

- 참조 속성이 **또한** 복제된 인스턴스를 참조하면,
  복사본은 복제를 참조합니다.
- 참조 속성이 **복제되지 않은** 인스턴스를 참조하면,
  복사본에서 동일한 값이 유지됩니다.


Instance:Clone

인스턴스의 복사본 또는 인스턴스가 `Class.Instance.Archivable|Archivable`가 아닌 경우 `nil`입니다.


인스턴스와 모든 자손의 복사본을 생성하며,
`Class.Instance.Archivable|Archivable`이 아닌 인스턴스는 무시합니다.


Instance:clone

`Class.Instance:Destroy()` 함수를 사용하여 Part를 파괴하는 방법을 보여줍니다.

이 함수는 더 이상 필요하지 않은 객체를 처리하는 올바른 방법입니다.

`Class.Instance.Parent` 속성을 `nil`로 설정하고,
`Class.Instance.Parent` 속성을 잠그며, 모든 연결을 끊고,
모든 자식에 대해 `Destroy()`를 호출합니다. 이 메서드는 더 이상 필요하지 않은 객체를 처리하는 올바른 방법입니다.

불필요한 객체를 처리하는 것은 중요합니다. 왜냐하면 장소에 불필요한 객체와 연결이 있으면
메모리를 소모하여 시간이 지남에 따라 심각한 성능 문제를 일으킬 수 있기 때문입니다.

`Destroy()`를 호출한 후에는 객체(또는 그 자손)를 참조하는 모든 변수를 `nil`로 설정하는 것이 좋습니다.
이렇게 하면 코드가 객체와 관련된 어떤 것도 접근하지 못하게 됩니다.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- 이렇게 하지 마세요:
print(part.Name)  --> "Hello, world"
-- 위의 줄이 작동하지 않도록 하려면:
part = nil
```

`Class.Instance`가 이 메서드에 의해 파괴된 후에는 재사용할 수 없습니다.
왜냐하면 `Class.Instance.Parent` 속성이 잠겨 있기 때문입니다. 객체를 **일시적으로** 제거하려면,
`Class.Instance.Parent|Parent`를 `nil`로 설정하십시오. 예를 들어:

```
local Workspace = game:GetService("Workspace")

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
설정된 시간 후에 객체를 파괴하려면 `Class.Debris:AddItem()`을 사용하십시오.


Instance:Destroy

`Class.Instance.Parent` 속성을 `nil`로 설정하고,
`Class.Instance.Parent` 속성을 잠그며, 모든 연결을 끊고,
모든 자식에 대해 `Destroy()`를 호출합니다.


Instance:destroy

주어진 이름과 같은 `Class.Instance.Name`을 가진 `Class.Instance`의 첫 번째 조상을 반환합니다.

이 메서드는 위로 작동하며, 인스턴스의 즉각적인 `Class.Instance.Parent`에서 시작하여
`Class.DataModel`까지 올라갑니다. 일치하는 조상이 없으면 `nil`을 반환합니다.

다음 코드 조각은 `Car`라는 이름의 객체의 첫 번째 조상을 찾습니다.

```
local car = object:FindFirstAncestor("Car")
```
특정 클래스의 조상을 찾는 이 메서드의 변형은 `Class.Instance:FindFirstAncestorOfClass()`와
`Class.Instance:FindFirstAncestorWhichIsA()`를 참조하십시오.


Instance:FindFirstAncestor

name

찾고자 하는 `Class.Instance.Name`입니다.


주어진 이름과 같은 `Class.Instance.Name`을 가진 `Class.Instance`의 첫 번째 조상을 반환합니다.


주어진 className과 같은 `Class.Object.ClassName`을 가진 `Class.Instance`의 첫 번째 조상을 반환합니다.

이 메서드는 위로 작동하며, 인스턴스의 즉각적인 `Class.Instance.Parent`에서 시작하여
`Class.DataModel`까지 올라갑니다. 일치하는 조상이 없으면 `nil`을 반환합니다.

이 메서드의 일반적인 사용은 `Class.BasePart`가 속한 `Class.Model`을 찾는 것입니다. 예를 들어:

```
local model = part:FindFirstAncestorOfClass("Model")
```
이 메서드는 `Class.Instance:FindFirstAncestor()`의 변형으로,
`Class.Object.ClassName` 속성을 확인하는 대신 `Class.Instance.Name`을 확인합니다.
`Class.Instance:FindFirstAncestorWhichIsA()`도 존재하며,
`Class.Object:IsA()` 메서드를 사용하여 클래스 상속을 존중합니다.


Instance:FindFirstAncestorOfClass

className

찾고자 하는 `Class.Object.ClassName`입니다.


주어진 className과 같은 `Class.Object.ClassName`을 가진 `Class.Instance`의 첫 번째 조상을 반환합니다.


주어진 className에 대해 `Class.Object:IsA()`가 true를 반환하는 `Class.Instance`의 첫 번째 조상을 반환합니다.

이 메서드는 위로 작동하며, 인스턴스의 즉각적인 `Class.Instance.Parent`에서 시작하여
`Class.DataModel`까지 올라갑니다. 일치하는 조상이 없으면 `nil`을 반환합니다.

`Class.Instance:FindFirstAncestorOfClass()`와는 달리, 이 메서드는
`Class.Object:IsA()`를 사용하여 클래스 상속을 존중합니다. 예를 들어:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
따라서 다음 코드 샘플은 첫 번째 `Class.BasePart` 조상을 반환합니다.
`Class.WedgePart`, `Class.MeshPart` 또는 `Class.Part`인지 여부에 관계없이.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
또한 `Class.Instance:FindFirstAncestor()`를 참조하십시오.


Instance:FindFirstAncestorWhichIsA

주어진 className에 대해 `Class.Object:IsA()`가 true를 반환하는 `Class.Instance`의 첫 번째 조상을 반환합니다.


아래 코드는 Workspace에서 객체 이름 "Brick"을 찾습니다. 찾으면,
객체의 이름을 "Foo"로 변경합니다.

주어진 이름을 가진 `Class.Instance`의 첫 번째 자식을 반환하며,
해당 자식이 존재하지 않으면 `nil`을 반환합니다. 선택적 `recursive` 인수가
`true`인 경우, 이 메서드는 `Class.Instance`의 즉각적인 자식뿐만 아니라 모든 자손을 검색합니다.

#### 객체 존재 확인

`FindFirstChild()`는 객체가 존재하는지 확인해야 할 경우 필요합니다.
이름을 사용하여 자식을 인덱싱하려고 하면 자식이 존재하지 않으면 오류가 발생합니다.

```lua
local Workspace = game:GetService("Workspace")

-- 다음 줄은 파트가 작업 공간에 존재하지 않으면 오류가 발생합니다.
Workspace.Part.Transparency = 0.5
```
더 나은 접근 방식은 `FindFirstChild()`를 사용하여 먼저 `Part`를 확인한 다음,
필요한 코드를 실행하기 위해 `if` 문을 사용하는 것입니다.

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace:FindFirstChild("Part")
if part then
	part.Transparency = 0.5
end
```

#### 속성과 일치하는 이름의 자식 찾기

때때로 객체의 `Class.Instance.Name|Name`이 그 `Class.Instance.Parent|Parent`의 속성과 동일합니다.
점 연산자를 사용할 때, 속성은 이름이 동일한 경우 자식보다 우선합니다.

다음 예제에서는 `Color`라는 `Class.Folder`가 `Class.Part`에 추가되며,
`Class.Part.Color` 속성도 있습니다. `part.Color`는 자식 `Class.Folder` 인스턴스가 아닌
`Datatype.Color3` 속성 값을 참조합니다. `Class.Instance:FindFirstChild()|FindFirstChild()`를 사용하면
새로운 속성이 도입되더라도 코드에 위험을 주지 않습니다.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- 속성
local c2 = part:FindFirstChild("Color")  -- 자식 폴더
```

#### 성능 주의 사항

`Class.Instance:FindFirstChild()|FindFirstChild()`는 점 연산자를 사용하는 것보다 약 20% 더 오래 걸리며,
객체에 대한 참조를 저장하는 것보다 거의 8배 더 오래 걸립니다. 따라서 성능에 의존하는 코드에서
이 메서드를 호출하는 것을 피해야 합니다. 예를 들어, 긴 루프나 `Class.RunService.Heartbeat` 및
`Class.RunService.PreRender`에 연결된 함수에서 호출하는 것을 피하십시오.
대신 결과를 변수에 저장하거나 `Class.Instance.ChildAdded|ChildAdded` 또는
`Class.Instance:WaitForChild()|WaitForChild()`를 사용하여 주어진 이름의 자식이
사용 가능해질 때 감지하는 것을 고려하십시오.


Instance:FindFirstChild

검색할 `Class.Instance.Name`입니다.


recursive

검색이 재귀적으로 수행되어야 하는지 여부입니다.


주어진 이름을 가진 `Class.Instance`의 첫 번째 자식을 반환합니다.


Instance:findFirstChild

주어진 `className`과 같은 `Class.Object.ClassName|ClassName`을 가진 `Class.Instance`의 첫 번째 자식을 반환합니다.
`Class.Instance:FindFirstChildWhichIsA()`와는 달리, 이 메서드는 클래스 상속을 무시하고
`className`과 일치하는 객체만 반환합니다. 일치하는 자식이 없으면 이 메서드는 `nil`을 반환합니다.


Instance:FindFirstChildOfClass

주어진 클래스 이름과 같은 `Class.Object.ClassName|ClassName`을 가진 `Class.Instance`의 첫 번째 자식을 반환합니다.


Instance

`Instance`는 Roblox 클래스 계층의 모든 클래스의 기본 클래스입니다
`Class.DataModel` 트리의 일부가 될 수 있습니다.


/reference/engine/classes/BillboardGui.yaml

요약