A `Class.UIListLayout`는 부모 UI 컨테이너 내에서 형제 UI 요소를 행 또는 열로 배치하고,
`Class.UIListLayout.FillDirection|FillDirection`에 따라 설정됩니다. 각 형제 `Class.GuiObject`의
`Class.GuiObject.Position|Position` 및 `Class.GuiObject.Rotation|Rotation` 속성은
리스트 레이아웃에 의해 무시되거나 덮어씌워지며, 각 형제는 레이아웃이 flex 레이아웃을 사용하도록 설정되지
않는 한 정의된 `Class.GuiObject.Size|Size`를 유지합니다. 자세한 내용은 [리스트 및 플렉스 레이아웃](/ui/list-flex-layouts)를 참조하세요.

<img src="../../../assets/engine-api/classes/UIListLayout/FillDirection.png"
width="720" alt="FillDirection이 수평 또는 수직인 UIListLayouts를 보여주는 이미지." />

형제의 레이아웃 순서를 제어하려면
`Class.UIListLayout.SortOrder|SortOrder`를 `Enum.SortOrder.Name` 또는
`Enum.SortOrder.LayoutOrder`로 설정한 다음,
형제를 알파벳 순서로 이름을 바꾸거나 각각의 `Class.GuiObject.LayoutOrder|LayoutOrder` 값을 설정하세요.
`Class.UIListLayout`은 요소가 추가/제거되거나 형제의 `Class.Instance.Name|Name` 또는
`Class.GuiObject.LayoutOrder|LayoutOrder`가 변경될 때 자동으로 요소를 재배치합니다.

<img src="../../../assets/engine-api/classes/UIListLayout/SortOrder.png"
width="720" alt="수치적 LayoutOrder 정렬 또는 알파벳적 이름 정렬을 보여주는 리스트 레이아웃 예제." />

형제 간의 패딩은`Class.UIListLayout.Padding|Padding` 속성을 통해 제어되며,
부모 컨테이너의 경계 내에서의 래핑은 `Class.UIListLayout.Wraps|Wraps` 불리언을 통해 제어됩니다.
부모 컨테이너 내에서 형제의 정렬은 `Class.UIListLayout.HorizontalAlignment|HorizontalAlignment` 및
`Class.UIListLayout.VerticalAlignment|VerticalAlignment`를 통해 제어됩니다.
플렉스 레이아웃을 사용하도록 설정되지 않는 한,
[플렉스 레이아웃](/ui/list-flex-layouts#flex-layouts)을 사용하도록 설정할 수 있습니다.

[플렉스 활성화된](/ui/list-flex-layouts#flex-layouts) 리스트 레이아웃을 사용할 때는 성능에 영향을 미칠 수 있습니다.
flex 기반 크기, flexed 크기 및 줄 바꿈을 계산하는 추가 계산이 필요하기 때문입니다.
`Class.UIListLayout`에서 플렉스가 활성화되려면 아래 속성이 설정되어 있거나,
`Class.GuiObject` 형제 중 하나에 `Class.UIFlexItem`이 부모로 붙어 있어야 합니다:

- `Class.UIListLayout.HorizontalFlex|HorizontalFlex` 및/또는
  `Class.UIListLayout.VerticalFlex|VerticalFlex`가 **아니어야** 합니다.
  `Enum.UIFlexAlignment.None`으로 설정되어 있어야 합니다.
- `Class.UIListLayout.ItemLineAlignment|ItemLineAlignment`가 **아니어야** 합니다.
  `Enum.ItemLineAlignment.Automatic`으로 설정되어 있어야 합니다.
- `Class.UIListLayout.Wraps|Wraps`가 `true`여야 합니다.

UIListLayout

리스트 레이아웃의 `Class.UIListLayout.FillDirection|FillDirection`이
`Enum.FillDirection.Horizontal`로 설정될 때,
`Class.UIListLayout.HorizontalFlex|HorizontalFlex` 속성은
부모 컨테이너에서 여분의 수평 공간을 분배하는 방법을 지정합니다.

<table size="small">
  <thead>
    <tr>
      <th>설정</th>
      <th>형제 동작</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>Enum.UIFlexAlignment.None|None</code></td>
      <td>플렉스 동작 없음; 형제는 정의된 너비를 유지합니다.</td>
    </tr>
    <tr>
      <td><code>Enum.UIFlexAlignment.Fill|Fill</code></td>
      <td>형제가 수평으로 재조정되어 전체 부모 컨테이너를 채우고, 정의된 너비를 오버라이드합니다. 동일한 행에 있는 형제의 개수는 변경되지 않습니다; 예를 들어, <code>Enum.UIFlexAlignment.None|None</code> 설정에서, 세 개의 형제가 컨테이너의 너비 내에서 수평으로 맞을 경우, 그 세 개의 형제가 전체 너비를 채우도록 재조정됩니다.</td>
    </tr>
    <tr>
      <td><code>Enum.UIFlexAlignment.SpaceAround|SpaceAround</code></td>
      <td>형제는 정의된 너비를 유지합니다. 각 형제의 양쪽에 동일한 간격이 추가됩니다.</td>
    </tr>
    <tr>
      <td><code>Enum.UIFlexAlignment.SpaceBetween|SpaceBetween</code></td>
      <td>형제는 정의된 너비를 유지합니다. 형제 사이에 동일한 간격이 추가되지만,
형제 주위에는 추가 공간이 추가되지 않습니다.</td>
    </tr>
    <tr>
      <td><code>Enum.UIFlexAlignment.SpaceEvenly|SpaceEvenly</code></td>
      <td>형제는 정의된 너비를 유지합니다. 형제 사이와 주위에 모두 동일한 간격이 추가됩니다.</td>
    </tr>
  </tbody>
</table>

<img src="../../../assets/engine-api/classes/UIListLayout/HorizontalFlex-Options.png" width="800" alt="각 HorizontalFlex 옵션이 형제 UI 객체의 크기와 간격에 어떻게 영향을 미치는지를 보여주는 UIListLayout 예제." />

##### 교차 방향 동작

**수직** 리스트 레이아웃에서는
(`Class.UIListLayout.FillDirection|FillDirection`이
`Enum.FillDirection.Vertical`로 설정되면),
`Class.UIListLayout.HorizontalFlex|HorizontalFlex` 속성은 형제를 **수평 교차 방향**으로
배치하는 방법을 지정합니다. 이러한 레이아웃에서, `Enum.UIFlexAlignment.Fill` 설정은
형제가 전체 수평 공간을 채우도록 합니다.
수직 간격은 `Class.UIListLayout.VerticalFlex|VerticalFlex`에 따릅니다.

<img src="../../../assets/engine-api/classes/UIListLayout/HorizontalFlex-Cross-Direction.png" width="720" alt="UIListLayout fill direction이 수직으로 설정된 경우 형제 UI 객체의 수평 크기에 HorizontalFlex가 어떻게 영향을 미치는지를 보여주는 다이어그램입니다." />

##### AutomaticSize 상호작용

`Class.GuiObject.AutomaticSize`가 `Class.UIListLayout`의 자식에 대해 활성화될 경우,
`Class.UIListLayout.FillDirection|FillDirection`에서 "자동 플렉스 기준"으로 해석되며,
`Class.GuiObject`의 크기를 정의하여 성장이 가능하거나 축소될 수 있습니다.

`Class.GuiObject.AutomaticSize`가 교차 방향의 `Class.UIListLayout` 자식에 대해 활성화될 경우,
"자동 교차 크기"로 해석되며,
교차 방향에서 모든 자식을 포함하는 데 필요한 최소 크기를 정의합니다.

UIListLayout.HorizontalFlex

여분의 수평 공간을 분배하는 방법을 제어합니다.

플렉스 레이아웃에서는 형제의 **교차 방향** 정렬을 정의합니다.
예제는 `Enum.ItemLineAlignment`를 참조하십시오.

<table size="small">
  <thead>
    <tr>
      <th>설정</th>
      <th>형제 동작</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>Enum.ItemLineAlignment.Automatic|Automatic</code></td>
      <td>레이아웃의 형제 또는 특정 <code>Class.UIFlexItem</code> 부모를 레이아웃의 <code>Class.UIListLayout.HorizontalAlignment|HorizontalAlignment</code> 또는 <code>Class.UIListLayout.VerticalAlignment|VerticalAlignment</code>에 정렬합니다. <code>Class.UIListLayout.FillDirection|FillDirection</code>에 따라 다릅니다.</td>
    </tr>
    <tr>
      <td><code>Enum.ItemLineAlignment.Start|Start</code></td>
      <td>레이아웃의 형제 또는 특정 <code>Class.UIFlexItem</code> 부모를 수평 채우기의 <b>상단</b> 또는 수직 채우기의 <b>왼쪽</b>에 정렬합니다.</td>
    </tr>
    <tr>
      <td><code>Enum.ItemLineAlignment.Center|Center</code></td>
      <td>레이아웃의 형제 또는 특정 <code>Class.UIFlexItem</code> 부모를 수평 및 수직 채우기 모두의 <b>중앙</b>에 정렬합니다.</td>
    </tr>
    <tr>
      <td><code>Enum.ItemLineAlignment.End|End</code></td>
      <td>레이아웃의 형제 또는 특정 <code>Class.UIFlexItem</code> 부모를 수평 채우기의 <b>하단</b> 또는 수직 채우기의 <b>오른쪽</b>에 정렬합니다.</td>
    </tr>
    <tr>
      <td><code>Enum.ItemLineAlignment.Stretch|Stretch</code></td>
      <td>레이아웃의 형제 또는 특정 <code>Class.UIFlexItem</code> 부모를 수평 또는 수직 채우기 둘 다의 교차 방향을 전체적으로 채우도록 늘립니다.</td>
    </tr>
  </tbody>
</table>

<img src="../../../assets/engine-api/classes/UIListLayout/ItemLineAlignment.png" width="720" alt="수평 채우기 방향에서 ItemLineAlignment의 옵션 예제." />

UIListLayout.ItemLineAlignment

플렉스 레이아웃에서, 줄 내 형제의 **교차 방향** 정렬을 정의합니다.

각 요소 간의 자유 공간의 양을 결정하며, 현재 방향에서 부모 크기의 비율(스케일) 또는 정적 공간 값(픽셀 크기와 유사)으로 설정될 수 있습니다.

UIListLayout.Padding

리스트 레이아웃의 `Class.UIListLayout.FillDirection|FillDirection`이
`Enum.FillDirection.Vertical`로 설정될 때,
`Class.UIListLayout.VerticalFlex|VerticalFlex` 속성은 부모 컨테이너에서 여분의 수직 공간을 분배하는 방법을 지정합니다.

<table size="small">
  <thead>
    <tr>
      <th>설정</th>
      <th>형제 동작</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>Enum.UIFlexAlignment.None|None</code></td>
      <td>플렉스 동작 없음; 형제는 정의된 높이를 유지합니다.</td>
    </tr>
    <tr>
      <td><code>Enum.UIFlexAlignment.Fill|Fill</code></td>
      <td>형제가 수직으로 재조정되어 전체 부모 컨테이너를 채우고,
정의된 높이를 오버라이드합니다. 동일한 열에 있는 형제의 개수는 변경되지 않습니다; 예를 들어, <code>Enum.UIFlexAlignment.None|None</code> 설정에서, 세 개의 형제가 컨테이너의 높이 내에서 수직으로 맞을 경우, 그 세 개의 형제가 전체 높이를 채우도록 재조정됩니다.</td>
    </tr>
    <tr>
      <td><code>Enum.UIFlexAlignment.SpaceAround|SpaceAround</code></td>
      <td>형제는 정의된 높이를 유지합니다. 각 형제의 양쪽에 동일한 간격이 추가됩니다.</td>
    </tr>
    <tr>
      <td><code>Enum.UIFlexAlignment.SpaceBetween|SpaceBetween</code></td>
      <td>형제는 정의된 높이를 유지합니다. 형제 사이에 동일한 간격이 추가되지만,
형제 주위에는 추가 공간이 추가되지 않습니다.</td>
    </tr>
    <tr>
      <td><code>Enum.UIFlexAlignment.SpaceEvenly|SpaceEvenly</code></td>
      <td>형제는 정의된 높이를 유지합니다. 형제 사이와 주위에 모두 동일한 간격이 추가됩니다.</td>
    </tr>
  </tbody>
</table>

<img src="../../../assets/engine-api/classes/UIListLayout/VerticalFlex-Options.png" width="800" alt="각 VerticalFlex 옵션이 형제 UI 객체의 크기와 간격에 어떻게 영향을 미치는지를 보여주는 UIListLayout 예제입니다." />

##### 교차 방향 동작

**수평** 리스트 레이아웃에서는
(`Class.UIListLayout.FillDirection|FillDirection`이
`Enum.FillDirection.Horizontal`로 설정될 때),
`Class.UIListLayout.VerticalFlex|VerticalFlex` 속성은 형제를 **수직 교차 방향**으로
배치하는 방법을 지정합니다. 이러한 레이아웃에서, `Enum.UIFlexAlignment.Fill` 설정은
형제가 전체 수직 공간을 채우도록 합니다.
수평 간격은 `Class.UIListLayout.HorizontalFlex|HorizontalFlex`에 따릅니다.

<img src="../../../assets/engine-api/classes/UIListLayout/VerticalFlex-Cross-Direction.png" width="720" alt="UIListLayout fill direction이 수평으로 설정된 경우 형제 UI 객체의 수직 크기에 VerticalFlex가 어떻게 영향을 미치는지를 보여주는 다이어그램입니다." />

##### AutomaticSize 상호작용

`Class.GuiObject.AutomaticSize`가 `Class.UIListLayout`의 자식에 대해 활성화될 경우,
`Class.UIListLayout.FillDirection|FillDirection`에서 "자동 플렉스 기준"으로 해석되며,
`Class.GuiObject`의 크기를 정의하여 성장이 가능하거나 축소될 수 있습니다.

`Class.GuiObject.AutomaticSize`가 교차 방향의 `Class.UIListLayout` 자식에 대해 활성화될 경우,
"자동 교차 크기"로 해석되며,
교차 방향에서 모든 자식을 포함하는 데 필요한 최소 크기를 정의합니다.

UIListLayout.VerticalFlex

여분의 수직 공간을 분배하는 방법을 제어합니다.

형제가 기본 크기가 컨테이너의 크기를 초과할 때,
부모 컨테이너 내에서 다른 줄로 줄 바꿈되는지를 제어합니다.

<img src="../../../assets/engine-api/classes/UIListLayout/Wraps.png" width="800" alt="Wraps가 부모 컨테이너의 경계 내에서 형제가 배포되는 방식에 어떻게 영향을 미치는지를 보여주는 다이어그램입니다." />

UIListLayout.Wraps

부모 컨테이너 내에서 형제가 줄 바꿈되는지 여부를 제어합니다.

부모 UI 컨테이너 내에서 형제 UI 요소를 행 또는 열로 배치합니다.

그리드 스타일 UI 레이아웃을 위한 기본 클래스입니다.

이 코드 샘플은 `Class.UIGridStyleLayout.SortOrder`와 `Class.GuiObject.LayoutOrder`를 사용하여 데이터를 정렬하는 방법을 보여줍니다.


ApplyLayout 메서드는 형제 UI 요소가 정렬 기준이 변경된 경우(예: `Class.UIGridStyleLayout.SortOrder`가 사용자 정의로 설정될 때 및 `Class.UIGridStyleLayout:SetCustomSortFunction()` 동작이 변경됨) 재배치되도록 강제합니다. UI 요소가 추가되거나 제거되거나 `Class.Instance.Name` 또는 `Class.GuiObject.LayoutOrder`가 변경되면 자연스럽게 재배치가 발생합니다.

형제 UI 요소가 배치되는 방식은 이 추상 클래스의 구현에 따라 다릅니다. 다시 말해 `Class.UIListLayout` 또는 `Class.UIGridLayout`과 같은 구체적 클래스가 실제 요소 위치 지정을 담당합니다.

UIGridStyleLayout:ApplyLayout

형제 UI 요소의 레이아웃을 강제로 다시 설정합니다.

이 메서드는 더 이상 사용되지 않습니다. 대신 `Class.UIGridStyleLayout.SortOrder`를 사용하세요.

함수는 두 개의 인수를 받아야 합니다(각 인수는 비교할 `Class.Instance` 자식입니다) 및 a가 b보다 먼저 오는 경우 true를 반환하고, 그렇지 않으면 false를 반환해야 합니다. 다시 말해, 이 함수를 '함수와 같은 방식으로 사용하세요. 정렬은 결정론적이어야 하며, 그렇지 않으면 정렬이 실패하고 이름 순서로 돌아갑니다.

UIGridStyleLayout:SetCustomSortFunction

function

SortOrder가 사용자 정의로 설정될 때 요소의 순서를 결정하는 데 사용되는 함수를 설정합니다.

UIGridStyleLayout

`Class.UIGridStyleLayout`의 **AbsoluteContentSize** 속성은 그리드의 요소가 차지하고 있는 공간의 크기를 드러냅니다. 여기에는 그리드에 의해 생성된 여백도 포함됩니다. 이 속성은 `Class.Frame|Frames`와 같은 그리드의 컨테이너 크기를 결정하는 데 특히 유용합니다.

이 속성은 읽을 때 즉시 업데이트됩니다. UI가 변경된 직후에는 `Class.Object.Changed` 이벤트가 발생하지 않지만, 값이 읽히면 현재 상태가 되고 다음 렌더 단계에서 `Class.Object.Changed` 이벤트가 발생합니다.

UIGridStyleLayout.AbsoluteContentSize

그리드 레이아웃이 차지하는 공간의 절대 크기입니다.

**FillDirection** 속성은 UI 요소가 배치될 축을 결정합니다. `Enum.FillDirection.Horizontal`은 객체를 왼쪽에서 오른쪽으로 배치하며, `Enum.FillDirection.Vertical`은 객체를 위에서 아래로 배치합니다. 요소의 순서를 뒤집으려면, 예를 들어 오른쪽에서 왼쪽으로 배치하려면 자식 UI 객체의 `Class.GuiObject.LayoutOrder` 값을 부정하여 정렬을 뒤집어야 합니다. `Class.UIGridStyleLayout.SortOrder`가 `Enum.SortOrder.LayoutOrder`로 설정되어 있을 때 그렇습니다.

<img src="../../../assets/engine-api/classes/UIListLayout/FillDirection.png" width="720" />

UIGridStyleLayout.FillDirection

UI 객체가 배치될 축을 결정합니다.

**HorizontalAlignment** 속성은 UI 요소 그리드의 **X** 축 정렬을 결정합니다. 이는 `Class.TextLabel.TextXAlignment`가 `Class.TextLabel.Text`와 함께 하는 방식과 유사합니다.

UIGridStyleLayout.HorizontalAlignment

부모 요소 내에서 UI 요소의 수평 정렬을 결정합니다.

**SortOrder** 속성은 레이아웃에서 자식 UI 객체가 배치되는 순서를 결정합니다.

`Enum.SortOrder.LayoutOrder`의 경우, 자식 UI 객체의 `Class.GuiObject.LayoutOrder|LayoutOrder` 속성에 대해 오름차순 정렬이 사용됩니다. 두 자식이 동일한 `Class.GuiObject.LayoutOrder|LayoutOrder`를 공유하는 경우, 부모 객체에 더 일찍 추가된 객체가 우선합니다.

`Enum.SortOrder.Name`의 경우, 자식 UI 객체의 `Class.Instance.Name`에 대해 알파벳 숫자 정렬이 사용됩니다.

<img src="../../../assets/engine-api/classes/UIListLayout/SortOrder.png" width="720" />

UIGridStyleLayout.SortOrder

레이아웃에서 자식 UI 객체가 배치되는 순서를 결정합니다.

**VerticalAlignment** 속성은 UI 요소 그리드의 **Y** 축 정렬을 결정합니다. 이는 `Class.TextLabel.TextYAlignment`가 `Class.TextLabel.Text`와 함께 하는 방식과 유사합니다.

UIGridStyleLayout.VerticalAlignment

부모 요소 내에서 UI 요소의 수직 정렬을 결정합니다.

UI 레이아웃 클래스의 기본 클래스입니다.


UILayout

UI 제약 및 레이아웃 클래스의 기본 클래스이며, `Class.UIBase`에서 상속받습니다.


UIComponent

UI 제약 및 레이아웃 클래스의 기본 클래스입니다.


`Class.UIBase`는 UI 레이아웃 및 제약 클래스의 기본 클래스입니다.


UIBase

`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`의 첫 번째 자식을 반환합니다.


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

일치하는 자식이 없으면 이 메서드는 `nil`을 반환합니다. 선택적 `recursive` 인수가 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

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


주어진 `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

인스턴스와 연결된 `Class.Actor`를 반환합니다. 있으면.


이 메서드는 주어진 속성 이름에 할당된 값을 반환합니다. 속성이 할당되지 않은 경우 `nil`이 반환됩니다.

예를 들어, 다음 코드 조각은 인스턴스의 `InitialPosition` 속성을 설정한 다음 가져옵니다:

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

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local initialPosition = instance:GetAttribute("InitialPosition")
print(initialPosition)
```

#### 참조

- 주어진 이름으로 속성을 설정하는 `Class.Instance:SetAttribute()`.
- 인스턴스의 각 속성에 대한 키-값 쌍의 사전을 반환하는 `Class.Instance:GetAttributes()`.


Instance:GetAttribute

주어진 속성 이름에 할당된 값입니다. 속성이 할당되지 않은 경우 `nil`이 반환됩니다.


주어진 속성 이름에 할당된 값을 반환합니다.


이 메서드는 `Class.Object.Changed|Changed` 이벤트와 정확히 같은 방식으로 작동하는 이벤트를 반환합니다.
단, 특정 주어진 속성이 변경될 때만 발생합니다. 효과적으로 `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`과 유사하지만 속성에 대한 것입니다.

일반적으로 이 메서드를 사용하는 것이 좋습니다. `Class.Object.Changed|Changed`에 연결하여 속성 이름을 확인하는 함수와 함께 사용하는 것보다.
같은 객체에 대해 동일한 속성 이름으로 이 메서드를 후속 호출하면 동일한 이벤트가 반환됩니다.

다음 코드 예제는 파트의 `InitialPosition` 속성이 변경될 때 `attributeChanged()` 함수를 발생시키는 신호를 반환합니다:

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

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local function attributeChanged()
	print("속성이 변경되었습니다.")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
또한 인스턴스에서 속성이 변경될 때마다 발생하는 `Class.Instance.AttributeChanged`를 참조하십시오.


Instance:GetAttributeChangedSignal

변경 신호를 반환할 특정 속성의 이름입니다.


주어진 속성이 변경될 때 발생하는 이벤트입니다.


주어진 속성이 변경될 때 발생하는 이벤트를 반환합니다.


이 메서드는 각 속성의 이름이 키이고 값이 비-`nil` 값인 키-값 쌍의 사전을 반환합니다.

예를 들어, 다음 코드 조각은 인스턴스의 속성과 값을 출력합니다:

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

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)
part:SetAttribute("CanUse", true)

for name, value in part:GetAttributes() do
	print(name .. " = " .. value)
end
```
또한 주어진 속성 이름에 할당된 값을 반환하는 `Class.Instance:GetAttribute()`를 참조하십시오.


Instance:GetAttributes

각 속성의 이름이 문자열이고 값이 비-`nil` 값인 키-값 쌍의 사전입니다.


인스턴스의 속성 사전을 반환합니다.


아래 코드는 실행 시 워크스페이스에 있는 모든 객체의 이름을 출력합니다.

인스턴스의 모든 직접 자식을 포함하는 배열(숫자 인덱스 테이블)을 반환합니다.
또는 `Class.Instance`의 `Class.Instance.Parent|Parent`가 객체와 같은 모든 `Class.Instance`입니다.
배열은 숫자 또는 일반 `for` 루프를 사용하여 반복할 수 있습니다:

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

-- 숫자 루프 예제
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. "는 자식 번호 " .. i)
end
```

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

-- 일반 루프 예제
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. "는 자식 번호 " .. i)
end
```
반환된 배열은 **특정 순서로 정렬되지 않으므로**, 수동 정렬(예: `Library.table.sort()`)을 권장합니다.
이 메서드에 의해 반환된 자식을 정렬합니다.

또한 `Class.Instance:GetDescendants()|GetDescendants()` 메서드를 참조하십시오.


Instance:GetChildren

인스턴스의 자식을 포함하는 배열입니다.


인스턴스의 모든 자식을 포함하는 배열을 반환합니다.


Instance:getChildren

Roblox에서 내부적으로 사용되는 디버그 ID의 코드화된 문자열을 반환합니다. 다음 사항에 유의하십시오:

- 이 항목은 보호됩니다. `Class.Script` 또는 `Class.LocalScript`에서 사용하려고 하면 오류가 발생합니다.
- 디버그 ID는 디버깅 프로세스에서 사용되는 ID입니다. 디버거가 애플리케이션이 처리하기 전에 각 명령을 읽을 수 있게 해줍니다. Roblox의 모든 객체는 프로세스처럼 작동하며,
필요할 경우 디버깅할 수 있는 실행 명령(또는 '코드')을 실행합니다.
- 이는 유사한 객체를 구별해야 하는 플러그인에 유용할 수 있습니다(예: 동일한 이름을 공유하는 객체).


Instance:GetDebugId

scopeLength

Roblox에서 내부적으로 사용되는 디버그 ID의 코드화된 문자열을 반환합니다.


GetDescendants는 특정 유형의 객체에 속한 모든 자손에게 무언가를 수행하는 데 자주 사용됩니다. 이 예제의 코드는 GetDescendants와
`Class.Instance:IsA()`를 사용하여 작업 공간의 모든 부품을 찾아 녹색으로 변경합니다.

이 객체 메서드는 해당 객체의 모든 자손을 포함하는 배열을 반환합니다.
`Class.Instance:GetChildren()`과는 달리, 이 메서드는 객체의 모든 자식, 그 자식의 모든 자식 등을 찾습니다.

반환된 배열은 **특정 순서로 정렬되지 않으므로**, 수동 정렬(예: `Library.table.sort()`)을 권장합니다.
이 메서드에 의해 반환된 자손을 정렬합니다. 또한 선택자와 조합자의 조합으로 자손을 쿼리하는 `Class.Instance:QueryDescendants()|QueryDescendants()` 메서드를 고려하십시오.


Instance:GetDescendants

인스턴스의 자손을 포함하는 배열입니다.


인스턴스의 모든 자손을 포함하는 배열을 반환합니다.


이 코드 샘플은 `Class.Instance:GetFullName()`의 동작을 보여줍니다.
`DataModel` 계층에 없는 객체에서 호출될 때 함수가 어떻게 작동하는지 보여주며, 
반환값이 특수 문자를 탈출하지 않는 방법도 보여줍니다.

이 코드 샘플은 `Class.Instance:GetFullName()` 함수를 Lua로 다시 구현합니다.


인스턴스의 조상을 설명하는 문자열을 반환합니다. 문자열은 객체의 `Class.Instance.Name|Name`과
그 조상들을 마침표로 구분하여 연결한 것입니다. `Class.DataModel`(`game`)은 고려되지 않습니다.
예를 들어, `Class.Workspace`의 `Class.Part`는 `Class.Workspace.Part`를 반환할 수 있습니다.

`Class.DataModel`의 자손이 아닌 `Class.Instance`에서 호출할 경우,
이 메서드는 `Class.Instance.Parent|Parent`가 없는 최상위 조상까지 모든 조상을 고려합니다.

이 메서드는 로깅 및 디버깅에 유용합니다. 반환된 문자열을 유용한 작업을 위해 파싱하려고 시도하지 마십시오.
이 메서드는 객체 이름의 마침표(또는 기타 기호)를 이스케이프하지 않습니다. 다시 말해,
출력이 종종 유효한 Luau 식별자인 것처럼 보이지만 보장되지 않습니다.


Instance:GetFullName

전체 `Class.Instance` 이름입니다.


인스턴스의 조상을 설명하는 문자열을 반환합니다.


이것은 `Class.Instance:GetStyled()`를 보여줍니다.


이 메서드는 지정된 속성의 스타일이 지정되거나 명시적으로 수정된 값을 반환합니다.
수정되지 않은 경우 기본 속성 값을 반환합니다. 이는 `[GuiObject].Rotation`과 같이 속성 값을 직접 접근하는 것과 약간 다릅니다.


Instance:GetStyled

selector

인스턴스에서 타겟팅하는 의사 인스턴스에 대한 선택적 선택자입니다.


지정된 속성의 스타일이 지정되거나 명시적으로 수정된 값입니다.
수정되지 않은 경우 기본 속성 값을 반환합니다.


지정된 속성의 스타일이 지정되거나 명시적으로 수정된 값을 반환합니다.
수정되지 않은 경우 기본 속성 값을 반환합니다.


이것은 `Class.Instance:GetStyledPropertyChangedSignal()`을 보여줍니다.


이 메서드는 `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` 이벤트와 정확히 같은 방식으로 작동하는 이벤트를 반환합니다.
단, 주어진 스타일 속성이 변경될 때만 발생합니다. 일반적으로 이 메서드를 사용하는 것이 좋습니다.
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`에 연결하여 속성 이름을 확인하는 함수와 함께 사용하는 것보다.
후속 호출 시 동일한 객체에 대해 동일한 속성 이름으로 이 메서드를 호출하면 동일한 이벤트가 반환됩니다.

이 이벤트는 연결된 함수에 인수를 전달하지 않으므로,
변경된 속성의 값은 스크립트 내에서 직접 읽어야 합니다.


Instance:GetStyledPropertyChangedSignal

property

변경 사항을 수신할 스타일 속성의 이름입니다.


주어진 스타일 속성이 변경될 때 발생하는 이벤트입니다.


인스턴스에서 주어진 스타일 속성이 변경될 때 발생하는 이벤트를 반환합니다.


이 메서드는 주어진 인스턴스에 적용된 태그의 배열을 문자열로 반환합니다.
Studio의 [속성](/studio/properties) 창에서 또는 런타임에 `Class.Instance:AddTag()|AddTag()`로 태그를 추가할 수 있습니다.

이 메서드는 인스턴스의 여러 태그로 작업할 때 유용합니다.
그러나 단일 태그의 존재를 확인하기 위해 이 메서드를 사용하는 것은 비효율적입니다.
대신 특정 태그를 확인하려면 `Class.Instance:HasTag()|HasTag()`를 사용하십시오.


Instance:GetTags

인스턴스에 적용된 태그를 나타내는 문자열 배열입니다.


인스턴스에 적용된 모든 태그의 배열을 가져옵니다.


이 메서드는 제공된 태그가 객체에 추가되었으면 `true`를 반환합니다.
Studio의 [속성](/studio/properties) 창에서 또는 런타임에 `Class.Instance:AddTag()|AddTag()`로 태그를 추가할 수 있습니다.


Instance:HasTag

인스턴스에서 확인할 태그입니다.


인스턴스에 주어진 태그가 있으면 `true`, 그렇지 않으면 `false`입니다.


인스턴스에 주어진 태그가 있는지 확인합니다.


Instance

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


/reference/engine/classes/UIListLayout.yaml

요약