모바일 장치의 홈 화면처럼 페이지가 나누어진 뷰잉 창을 생성합니다. 당신은 UIPageLayout을 GuiObject에 부모로 설정하여 사용할 수 있습니다. 그러면 UIPageLayout은 모든 GuiObject 형제에게 적용됩니다.


페이지가 뷰에 들어오고 렌더링될 때 발생합니다.


UIPageLayout.PageEnter

page

페이지가 뷰를 벗어날 때 발생하며, 렌더링되지 않습니다.


UIPageLayout.PageLeave

`Class.UIPageLayout.CurrentPage`로의 애니메이션이 취소되지 않고 완료되었을 때 발생하며, 뷰가 스크롤을 멈춥니다.


UIPageLayout.Stopped

currentPage

만약 `page`가 UIPageLayout에 있다면, `Class.UIPageLayout.CurrentPage`를 그것으로 설정하고 애니메이션을 수행합니다. 순환 레이아웃이 활성화되어 있다면, 이 페이지까지 가장 짧은 경로를 취합니다.


UIPageLayout:JumpTo

인덱스가 `>= 0`이고 레이아웃의 크기보다 작으면 이 메서드는 `Class.UIPageLayout:JumpTo()`처럼 작동합니다. 경계 밖일 경우이면서 순환이 설정되어 있다면, `Class.UIPageLayout.CurrentPage`의 경계 내 인덱스와 새 인덱스 간의 전체 거리를 애니메이션합니다.


UIPageLayout:JumpToIndex

index

`Class.UIPageLayout.CurrentPage`를 현재 페이지 이후의 페이지로 설정하고 애니메이션을 수행하거나, 다음 페이지가 없을 경우 아무 것도 하지 않습니다.


UIPageLayout:Next

`Class.UIPageLayout.CurrentPage`를 현재 페이지 이전의 페이지로 설정하고 애니메이션을 수행하거나, 이전 페이지가 없을 경우 아무 것도 하지 않습니다.


UIPageLayout:Previous

UIPageLayout

페이지 간 전환 애니메이션을 할지 여부.


UIPageLayout.Animated

페이지 레이아웃이 끝에서 둘러싸일지 여부.


UIPageLayout.Circular

현재 표시되고 있는 페이지 또는 현재 애니메이션의 대상이 되는 페이지.


UIPageLayout.CurrentPage

애니메이션을 수행할 때 사용할 완화 방향.


UIPageLayout.EasingDirection

애니메이션을 수행할 때 사용할 완화 스타일.


UIPageLayout.EasingStyle

`NextSelection{Up,Down,Left,Right}`의 오버라이드를 제어합니다. 기본값은 true입니다.


UIPageLayout.GamepadInputEnabled

`NextSelection{Up, Down, Left, Right}`의 오버라이드를 제어합니다. 기본값은 true입니다.


페이지 간의 간격을 결정합니다. 현재 방향의 부모 크기 비율을 사용하는 규모(Percentage) 또는 정적 간격 값, 즉 픽셀 크기와 유사한 오프셋을 사용하여 설정할 수 있습니다.


UIPageLayout.Padding

페이지 간의 간격을 결정합니다.


다른 용도로 예정된 경우 스크롤 휠 사용을 제어합니다. 기본값은 true입니다.


UIPageLayout.ScrollWheelInputEnabled

비인터랙티브 레이아웃인 경우 터치 스크롤링을 제어합니다. 기본값은 true입니다.


UIPageLayout.TouchInputEnabled

UIPageLayout.TweenTime

그리드 스타일 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, "변경됨")
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`를 반환합니다(존재하는 경우).

이 메서드는 주어진 속성 이름에 할당된 값을 반환합니다. 속성이 할당되지 않은 경우,
`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.Changed|Changed`에 대한 연결 대신 이
메서드를 사용하는 것이 좋습니다. 동일한 객체에서 동일한 속성 이름을 가진 다음 호출되는 이 메서드는 동일한 이벤트를 반환합니다.

다음 코드 예는 파트의 `InitialPosition` 속성이 변경될 때 `attributeChanged()` 함수를 발생시킵니다:

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

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

local function attributeChanged()
	print("Attribute changed")
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`와 동일합니다. 배열은 숫자 또는 일반 `for` 루프를 사용하여 반복할 수 있습니다:

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

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

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

-- 일반 루프 예
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " is child number " .. i)
end
```
반환된 배열은 특정 순서로 **정렬되지 않는다**는 점에 유의해야 하며,
이 메서드에서 반환된 자식을 정렬하고자 할 경우 수동 정렬(`Library.table.sort()`)을 권장합니다.

또한 `Class.Instance:GetDescendants()|GetDescendants()` 메서드도 참조하세요.

Instance:GetChildren

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

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

Instance:getChildren

로블록스에서 내부적으로 사용되는 디버그 ID의 인코딩 문자열을 반환합니다. 다음과 같이:

- 이 항목은 보호됩니다. `Class.Script` 또는 `Class.LocalScript` 내에서 사용할 경우 오류가 발생합니다.
- 디버그 ID는 디버깅 프로세스에 사용되는 ID입니다. 이는 디버거가
응용 프로그램이 프로세스 하기 전에 각 명령을 읽을 수 있도록 합니다. 로블록스의 모든 객체는
프로세스처럼 작동하며 디버그할 수 있는 각 실행 명령(또는 '코드')을 가지고 있습니다.
- 유사한 객체를 구별해야 하는 플러그인에 도움이 될 수 있습니다.
(예: 이름이 같은 객체들)

Instance:GetDebugId

scopeLength

로블록스에서 내부적으로 사용되는 디버그 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`의 전체 이름입니다.

인스턴스의 계보를 설명하는 문자열을 반환합니다.

이 메서드는 지정된 속성의 스타일이 지정된 값이나 명시적으로 수정된 값을 반환합니다. 그렇지 않다면,
수정되지 않은 기본 속성 값을 반환합니다. 이는 `[GuiObject].Rotation`과 같이 속성 값을 직접 액세스할 때와
약간 다릅니다. 기본 또는 수정된 속성의 값을 반환합니다.

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

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

local coreSheet = ReplicatedStorage:FindFirstChild("CoreSheet")
local rule = coreSheet:FindFirstChildWhichIsA("StyleRule")
rule.Selector = "TextButton"

-- 버튼에 대한 참조
local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

print(button:GetStyled("Rotation")) --> 0 (기본값)
print(button.Rotation) --> 0 (기본값)

-- 스타일 규칙 속성을 통해 회전 적용
rule:SetProperty("Rotation", 30)

print(button:GetStyled("Rotation")) --> 30 (규칙을 기반으로 한 스타일 값)
print(button.Rotation) --> 0 (기본값)

-- 스타일 속성을 명시적으로 수정/재정의
button.Rotation = 45

print(button:GetStyled("Rotation")) --> 45 (수정된 값)
print(button.Rotation) --> 45 (수정된 값)
```

Instance:GetStyled

selector

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

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

Instance

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

/reference/engine/classes/UIPageLayout.yaml