`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.LayerCollector`의 모든 자손에서 `Class.GuiObject.ZIndex`가 작동하는 방식을 제어합니다.

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

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


LayerCollector.ZIndexBehavior

`Class.LayerCollector`의 모든 자손에서 `Class.GuiObject.ZIndex`가 작동하는 방식을 제어합니다.


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

newSelection

게임패드 선택이 연결된 `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`는 자동 로컬라이제이션이 적용되도록
d이 `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.LocalizationTable`에 대한 참조입니다.

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

GuiBase2d.SelectionBehaviorDown

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

GuiBase2d.SelectionBehaviorLeft

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

GuiBase2d.SelectionBehaviorRight

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

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, "변경됨")
end

part.AttributeChanged:Connect(attributeChanged)
```
특정 속성이 변경될 때 발생하는 이벤트인 `Class.Instance:GetAttributeChangedSignal()`도 참조하십시오.

Instance.AttributeChanged

attribute

`Class.Instance`에서 속성이 변경될 때마다 발생합니다.

이 코드는 객체가 작업 공간에 추가될 때 그 이름을 출력합니다:

`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: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`를 삭제할 때, 탐색기를 통해 수동으로 삭제하거나 플러그인을 통해 삭제할 때, `Class.Instance`는 파괴되지 않습니다. 대신, 부모가 `nil`로 설정되며, 이는 `Class.Instance.AncestryChanged`로 추적할 수 있습니다.

Instance.Destroying

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

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

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

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("스타일 속성이 변경됨")
end

meterBar:StyledPropertiesChanged():Connect(stylePropertyChanged)
```

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.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`이 아닌 인스턴스는 무시합니다.

Instance:clone

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

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


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

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

`Destroy()`를 호출한 후 Best Practice로, 객체를 참조하는 모든 변수를(또는 자손)
`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`의 첫 번째 조상을 반환합니다.

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

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

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

Instance:FindFirstAncestor

name

주어진 이름과 동일한 `Class.Instance`의 첫 번째 조상을 반환합니다.

주어진 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`의 첫 번째 조상을 반환합니다.

지정한 className에 대해 `Class.Object:IsA()`가 true를 반환하는 첫 번째 조상을 반환합니다.

이 메서드는 위쪽으로 작동하며, 인스턴스의 즉각적인 `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를 반환하는 첫 번째 조상을 반환합니다.

아래 코드는 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.Instance`의 첫 번째 자식을 반환합니다.
`Class.Instance:FindFirstChildWhichIsA()`와는 달리, 이 메서드는
클래스 상속을 무시하고 클래스가 `className`과 일치하는 객체만 반환합니다.
일치하는 자식이 없으면 이 메서드는 `nil`을 반환합니다.

Instance:FindFirstChildOfClass

주어진 className과 동일한 `Class.Object.ClassName|ClassName`을 가진 `Class.Instance`의 첫 번째 자식을 반환합니다.

지정한 className에 대해 `Class.Object:IsA()`가 true를 반환하는 첫 번째 자식을 반환합니다.

일치하는 자식이 없으면 이 메서드는 `nil`을 반환합니다. 선택적
재귀 매개변수는 true인 경우, 이는 `Class.Instance`의 직접적인 자식뿐 아니라
모든 자손을 검색합니다.

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

```lua
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:FindFirstChildWhichIsA("BasePart")
```
이름으로 자식을 찾고자 하는 개발자는 대신 `Class.Instance:FindFirstChild()`를 사용해야 합니다.

Instance:FindFirstChildWhichIsA

검색할 `Class.Object.ClassName`입니다.

지정한 className에 대해 `Class.Object:IsA()`가 true를 반환하는 첫 번째 자식을 반환합니다.

지정된 `Class.Instance.Name`을 가진 첫 번째 자손을 반환합니다.

이 메서드는 비활성화되어 사용할 수 없습니다. 인스턴스의 첫 번째 자손을 찾으려면,
대신 `Class.Instance:FindFirstChild()`의 `recursive` 매개변수를 사용하는 것이 좋습니다.

Instance:FindFirstDescendant

지정된 `Class.Instance.Name`을 가진 첫 번째 자손을 반환합니다.

`Class.Instance`가 `Class.Actor`인 경우,
`Class.Actor` 자체가 반환됩니다. 그렇지 않은 경우 가장 가까운 조상인 `Class.Actor`가 반환됩니다.
조상이 `Class.Actor`가 없는 경우, 결과는 `nil`이 됩니다.

Instance:GetActor

`Instance`와 연결된 `Class.Actor`를 반환합니다(존재하는 경우).

Instance

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

/reference/engine/classes/BillboardGui.yaml