包含與特定物件不直接相關的幾何操作的服務。



以下範例顯示如何根據推薦的表格保留 `Class.Attachment|Attachments` 和 `Class.Constraint|Constraints`，該表格由 `Class.GeometryService:CalculateConstraintsToPreserve()|CalculateConstraintsToPreserve()` 生成。

返回一個表格，包含 `Class.Constraint|Constraints` 和 `Class.Attachment|Attachments`，您可以選擇保留它們及其各自的父物件。遍歷該表格讓您決定是否重新將建議的約束和附加物的父物件更改為各自的父物件。



GeometryService:CalculateConstraintsToPreserve

source

執行實體建模操作的原始物件，例如 `part` 在 `Class.GeometryService:UnionAsync()|UnionAsync()`。



destination

options

方法的選項字典：

- `tolerance` — 關於 `Class.Attachment` 保留的距離容忍度，表示附加物與原始部件表面之間的距離與結果部件表面之間最近點的距離。如果隨著實體建模操作結果的距離大於此值，返回的建議表格中的附加物和其相關約束的 `Class.Instance.Parent|Parent` 將為 `nil`。
- `weldConstraintPreserve` — 描述在結果建議表格中如何保留 `Class.WeldConstraint|WeldConstraints` 的 `Enum.WeldConstraintPreserve` 枚舉值。
- `dropAttachmentsWithoutConstraints` — 布林值，默認為 `true`。如果設置為 `false`，則不會保留沒有 `Class.Constraint|Constraints` 的 `Class.Attachment|Attachments`。


包含一般情況 `Class.Constraint|Constraints`、`Class.NoCollisionConstraint|NoCollisionConstraints` 和 `Class.WeldConstraint|WeldConstraints` 的信息的表格。在應丟棄 `Class.Attachment` 或 `Class.Constraint` 的情況下，其相應的父物件將為 `nil`。

對於一般情況的 `Class.Constraint|Constraints`，例如 `Class.HingeConstraint`：

<table size="small">
<thead>
  <tr>
    <th>Key</th>
    <th>Type</th>
  </tr>
</thead>
<tbody>
  <tr>
    <td><code>Attachment</code></td>
    <td><code>Class.Attachment</code></td>
  </tr>
  <tr>
    <td><code>Constraint</code></td>
    <td><code>Class.Constraint</code> 或 <code>nil</code></td>
  </tr>
  <tr>
    <td><code>AttachmentParent</code></td>
    <td><code>Class.BasePart</code> 或 <code>nil</code></td>
  </tr>
  <tr>
    <td><code>ConstraintParent</code></td>
    <td><code>Class.BasePart</code> 或 <code>nil</code></td>
  </tr>
</tbody>
</table>

對於 `Class.WeldConstraint|WeldConstraints`：

<table size="small">
<thead>
  <tr>
    <th>Key</th>
    <th>Type</th>
  </tr>
</thead>
<tbody>
  <tr>
    <td><code>WeldConstraint</code></td>
    <td><code>Class.WeldConstraint</code></td>
  </tr>
  <tr>
    <td><code>WeldConstraintParent</code></td>
    <td><code>Class.BasePart</code> 或 <code>nil</code></td>
  </tr>
  <tr>
    <td><code>WeldConstraintPart0</code></td>
    <td><code>Class.BasePart</code></td>
  </tr>
  <tr>
    <td><code>WeldConstraintPart1</code></td>
    <td><code>Class.BasePart</code></td>
  </tr>
</tbody>
</table>

對於 `Class.NoCollisionConstraint|NoCollisionConstraints`：

<table size="small">
<thead>
  <tr>
    <th>Key</th>
    <th>Type</th>
  </tr>
</thead>
<tbody>
  <tr>
    <td><code>NoCollisionConstraint</code></td>
    <td><code>Class.NoCollisionConstraint</code></td>
  </tr>
  <tr>
    <td><code>NoCollisionConstraintParent</code></td>
    <td><code>Class.BasePart</code> 或 <code>nil</code></td>
  </tr>
  <tr>
    <td><code>NoCollisionConstraintPart0</code></td>
    <td><code>Class.BasePart</code></td>
  </tr>
  <tr>
    <td><code>NoCollisionConstraintPart1</code></td>
    <td><code>Class.BasePart</code></td>
  </tr>
</tbody>
</table>


返回一個表格，包含 `Class.Constraint|Constraints` 和 `Class.Attachment|Attachments`，您可以選擇保留它們及其各自的父物件。



這個範例將 `mainPart` 的幾何形狀與 `otherParts` 陣列中的部件相交，將它們分割成不同的 `Class.PartOperation|PartOperations`。然後它會摧毀參與操作的原始部件。

從主部件和給定數組中的其他部件的交集幾何創建一個或多個 `Class.PartOperation|PartOperations`。僅支持原始的 `Class.Part|Parts` 和 `Class.PartOperation|PartOperations`，不支持 `Class.Terrain` 或 `Class.MeshPart|MeshParts`。類似於 `Class.Instance:Clone()|Clone()`，返回的部件沒有設置 `Class.Instance.Parent|Parent`。

主部件（`part`）的以下屬性應用於結果的 `Class.PartOperation|PartOperations`：

- `Class.BasePart.Color|Color`、`Class.BasePart.Material|Material`、`Class.BasePart.MaterialVariant|MaterialVariant`、`Class.BasePart.Reflectance|Reflectance`、`Class.BasePart.Transparency|Transparency`
- `Class.BasePart.CanCollide|CanCollide`
- `Class.BasePart.Anchored|Anchored`、`Class.BasePart.Density|Density`、`Class.BasePart.Elasticity|Elasticity`、`Class.BasePart.ElasticityWeight|ElasticityWeight`、`Class.BasePart.Friction|Friction`、`Class.BasePart.FrictionWeight|FrictionWeight`

在以下圖像比較中，使用紫色方塊和包含藍色方塊的數組調用 `Class.GeometryService:IntersectAsync()|IntersectAsync()`。結果的 `Class.PartOperation` 解析為兩個部件的交集幾何形狀。

<figure>
<img src="../../../assets/modeling/solid-modeling/Separate-Parts-To-Intersect.jpg"
width="720" alt="兩個方塊部件重疊" />
<figcaption>分開的部件</figcaption>
</figure>
<figure>
<img src="../../../assets/modeling/solid-modeling/Intersect-Result.jpg"
width="720" alt="部件交集形成一個新的實體模型" />
<figcaption>結果 <code>Class.PartOperation</code></figcaption>
</figure>

#### 注意事項

- 與 `Class.BasePart:IntersectAsync()` 相比，該方法的區別如下：

  - 輸入部件不需要父屬於場景，允許在背景操作。
  - 當 `SplitApart` 選項設置為 `true`（默認），每個不同的物體將在其自己的 `Class.PartOperation` 中返回。
  - 所有返回的部件都在主部件的坐標空間中。這表示任何返回部件的 `(0, 0, 0)` 不一定位於其主體的中心。
  - 客戶端可以調用此方法，但有些限制。首先，必須使用 **在客戶端創建的** 對象進行操作。其次，客戶端到服務器之間沒有複製可用。

- 原始部件在成功操作後保持完整。在大多數情況下，您應該將返回的 `Class.PartOperation|PartOperations` 置於與主部件相同的位置，然後通過 `Class.Instance.Destroy|Destroy()` 刪除所有原始部件。

- 默認情況下，結果 `Class.PartOperation|PartOperations` 的面顏色源自原始部件的 `Class.BasePart.Color|Color` 屬性，儘管您可以啟用它們的 `Class.PartOperation.UsePartColor|UsePartColor` 屬性將它們更改為特定顏色。

- 如果交集操作的結果中有任何 `Class.PartOperation|PartOperations` 的三角形數量超過 20,000，則將簡化為 20,000。這將導致代碼為 `-14` 的錯誤。

- 如果主部件在操作計算時正在移動，您可以將返回的部件設置為主部件的更新 `Datatype.CFrame`，因為返回的部件與主部件處於相同坐標空間。

- 如果使用此方法將 `Class.PartOperation` 作為主部件，您可以通過 `Class.PartOperation:SubstituteGeometry()|SubstituteGeometry()` 來替換另一個 `Class.PartOperation` 的幾何形狀，使其更容易利用操作的幾何形狀，同時保持主部件的屬性、屬性、標籤和子部件，例如 `Class.Attachment|Attachments`、`Class.Constraint|Constraints`、`Class.ParticleEmitter|ParticleEmitters`、燈光對象和貼圖。這種方法也可以避免完全替換原始 `Class.PartOperation` 時可能出現的閃爍問題。


GeometryService:IntersectAsync

part

要操作的主 `Class.Part` 或 `Class.PartOperation`。



parts

包含所有控制於方法的選項表：

- `CollisionFidelity` — 結果部件中的 `Class.PartOperation.CollisionFidelity|CollisionFidelity` 的值。
- `RenderFidelity` — 結果部件中的 `Class.PartOperation.RenderFidelity|RenderFidelity` 的值。
- `FluidFidelity` — 結果部件中的 `Class.PartOperation.FluidFidelity|FluidFidelity` 的值。
- `SplitApart` — 控制物件是否應該全部放在一起或正確拆分的布林值。默認為 `true`（拆分）。


從主部件（`part`）和其他部件的交集幾何中得到的一個或多個 `Class.PartOperation|PartOperations`。



從一個部件的交集幾何創建一個或多個 `Class.PartOperation|PartOperations`。



此範例從 `mainPart` 中減去 `otherParts` 陣列中零件的幾何形狀，將結果拆分為不同的 `Class.PartOperation|PartOperations`。然後，它會摧毀參與操作的原始零件。

從主部件減去給定陣列中其他部件佔據的幾何，創建一個或多個 `Class.PartOperation|PartOperations`。僅支持原始的 `Class.Part|Parts` 和 `Class.PartOperation|PartOperations`，不支持 `Class.Terrain` 或 `Class.MeshPart|MeshParts`。類似於 `Class.Instance:Clone()|Clone()`，返回的部件沒有設置 `Class.Instance.Parent|Parent`。

主部件（`part`）的以下屬性應用於結果的 `Class.PartOperation|PartOperations`：

- `Class.BasePart.Color|Color`、`Class.BasePart.Material|Material`、`Class.BasePart.MaterialVariant|MaterialVariant`、`Class.BasePart.Reflectance|Reflectance`、`Class.BasePart.Transparency|Transparency`
- `Class.BasePart.CanCollide|CanCollide`
- `Class.BasePart.Anchored|Anchored`、`Class.BasePart.Density|Density`、`Class.BasePart.Elasticity|Elasticity`、`Class.BasePart.ElasticityWeight|ElasticityWeight`、`Class.BasePart.Friction|Friction`、`Class.BasePart.FrictionWeight|FrictionWeight`

在以下圖像比較中，使用藍色圓柱體和包含紫色方塊的數組調用 `Class.BasePart:SubtractAsync()|SubtractAsync()`。結果的 `Class.PartOperation` 得到的形狀是圓柱體中省略方塊的幾何形狀。

<figure>
<img src="../../../assets/modeling/solid-modeling/Separate-Parts-To-Subtract.jpg"
width="720" alt="長方形方塊重疊一個圓柱體" />
<figcaption>分開的部件</figcaption>
</figure>
<figure>
<img src="../../../assets/modeling/solid-modeling/Negate-Result.jpg"
width="720"
alt="方塊從圓柱體中減去" />
<figcaption>結果 <code>Class.PartOperation</code></figcaption>
</figure>

#### 注意事項

- 與 `Class.BasePart:SubtractAsync()` 相比，該方法的區別如下：

  - 輸入部件不需要父屬於場景，允許在背景操作。
  - 當 `SplitApart` 選項設置為 `true`（默認），每個不同的物體將在其自己的 `Class.PartOperation` 中返回。
  - 所有返回的部件都在主部件的坐標空間中。這表示任何返回部件的 `(0, 0, 0)` 不一定位於其主體的中心。
  - 客戶端可以調用此方法，但有些限制。首先，必須使用 **在客戶端創建的** 對象進行操作。其次，客戶端到服務器之間沒有複製可用。

- 原始部件在成功操作後保持完整。在大多數情況下，您應該將返回的 `Class.PartOperation|PartOperations` 置於與主部件相同的位置，然後通過 `Class.Instance.Destroy|Destroy()` 刪除所有原始部件。

- 默認情況下，結果 `Class.PartOperation|PartOperations` 的面顏色源自原始部件的 `Class.BasePart.Color|Color` 屬性，儘管您可以啟用它們的 `Class.PartOperation.UsePartColor|UsePartColor` 屬性將它們更改為特定顏色。

- 如果減去操作的結果中有任何 `Class.PartOperation|PartOperations` 的三角形數量超過 20,000，則將簡化為 20,000。這將導致代碼為 `-14` 的錯誤。

- 如果主部件在操作計算時正在移動，您可以將返回的部件設置為主部件的更新 `Datatype.CFrame`，因為返回的部件與主部件處於相同坐標空間。

- 如果使用此方法將 `Class.PartOperation` 作為主部件，您可以通過 `Class.PartOperation:SubstituteGeometry()|SubstituteGeometry()` 來替換另一個 `Class.PartOperation` 的幾何形狀，使其更容易利用操作的幾何形狀，同時保持主部件的屬性、屬性、標籤和子部件，例如 `Class.Attachment|Attachments`、`Class.Constraint|Constraints`、`Class.ParticleEmitter|ParticleEmitters`、燈光物件和貼圖。這種方法也可以避免完全替換原始 `Class.PartOperation` 時可能出現的閃爍問題。


GeometryService:SubtractAsync

要從主部件中減去的部件陣列。



從主部件（`part`）減去其他部件佔據的幾何的數量為一個或多個 `Class.PartOperation|PartOperations`。



創建一個或多個 `Class.PartOperation|PartOperations`，從主部件中減去其他部件佔據的幾何。



此範例結合了 `mainPart` 與 `otherParts` 陣列中的部件的幾何形狀，然後摧毀參與操作的原始部件。

從主部件加上給定數組中其他部件佔據的幾何創建一個或多個 `Class.PartOperation|PartOperations`。僅支持原始的 `Class.Part|Parts` 和 `Class.PartOperation|PartOperations`，不支持 `Class.Terrain` 或 `Class.MeshPart|MeshParts`。類似於 `Class.Instance:Clone()|Clone()`，返回的部件沒有設置 `Class.Instance.Parent|Parent`。

主部件（`part`）的以下屬性應用於結果的 `Class.PartOperation|PartOperations`：

- `Class.BasePart.Color|Color`、`Class.BasePart.Material|Material`、`Class.BasePart.MaterialVariant|MaterialVariant`、`Class.BasePart.Reflectance|Reflectance`、`Class.BasePart.Transparency|Transparency`
- `Class.BasePart.CanCollide|CanCollide`
- `Class.BasePart.Anchored|Anchored`、`Class.BasePart.Density|Density`、`Class.BasePart.Elasticity|Elasticity`、`Class.BasePart.ElasticityWeight|ElasticityWeight`、`Class.BasePart.Friction|Friction`、`Class.BasePart.FrictionWeight|FrictionWeight`

在以下圖像比較中，使用藍色方塊和包含紫色圓柱體的數組調用 `Class.GeometryService:UnionAsync()|UnionAsync()`。結果的 `Class.PartOperation` 解析為兩個部件的結合幾何形狀。

<figure>
<img src="../../../assets/modeling/solid-modeling/Separate-Parts-To-Union.jpg"
width="720" alt="方塊和圓柱部件重疊" />
<figcaption>分開的部件</figcaption>
</figure>
<figure>
<img src="../../../assets/modeling/solid-modeling/Union-Result.jpg"
width="720"
alt="部件合併為一個實體聯合" />
<figcaption>結果 <code>Class.PartOperation</code></figcaption>
</figure>

#### 注意事項

- 與 `Class.BasePart:UnionAsync()` 相比，該方法的區別如下：

  - 輸入部件不需要父屬於場景，允許在背景操作。
  - 當 `SplitApart` 選項設置為 `true`（默認），每個不同的物體將在其自己的 `Class.PartOperation` 中返回。
  - 所有返回的部件都在主部件的坐標空間中。這表示任何返回部件的 `(0, 0, 0)` 不一定位於其主體的中心。
  - 客戶端可以調用此方法，但有些限制。首先，必須使用 **在客戶端創建的** 對象進行操作。其次，客戶端到服務器之間沒有複製可用。

- 原始部件在成功操作後保持完整。在大多數情況下，您應該將返回的 `Class.PartOperation|PartOperations` 置於與主部件相同的位置，然後通過 `Class.Instance.Destroy|Destroy()` 刪除所有原始部件。

- 默認情況下，結果 `Class.PartOperation|PartOperations` 的面顏色源自原始部件的 `Class.BasePart.Color|Color` 屬性，儘管您可以啟用它們的 `Class.PartOperation.UsePartColor|UsePartColor` 屬性將它們更改為特定顏色。

- 如果聯合操作的結果中有任何 `Class.PartOperation|PartOperations` 的三角形數量超過 20,000，則將簡化為 20,000。這將導致代碼為 `-14` 的錯誤。

- 如果主部件在操作計算時正在移動，您可以將返回的部件設置為主部件的更新 `Datatype.CFrame`，因為返回的部件與主部件處於相同坐標空間。

- 如果使用此方法將 `Class.PartOperation` 作為主部件，您可以通過 `Class.PartOperation:SubstituteGeometry()|SubstituteGeometry()` 來替換另一個 `Class.PartOperation` 的幾何形狀，使其更容易利用操作的幾何形狀，同時保持主部件的屬性、屬性、標籤和子部件，例如 `Class.Attachment|Attachments`、`Class.Constraint|Constraints`、`Class.ParticleEmitter|ParticleEmitters`、燈光物件和貼圖。這種方法也可以避免完全替換原始 `Class.PartOperation` 時可能出現的閃爍問題。


GeometryService:UnionAsync

從主部件（`part`）加上其他部件佔據的幾何得到的一個或多個 `Class.PartOperation|PartOperations`。



創建一個或多個 `Class.PartOperation|PartOperations`，從主部件中加上其他部件佔據的幾何。



GeometryService

`Instance` 是 Roblox 類別層級中所有類別的基礎類別，可以作為 `Class.DataModel` 樹的部分。

無法直接創建根 `Instance` 物件，但特別的 `Datatype.Instance.new()` 建構子可透過程式碼創建物件，並以類別名稱作為參數返回所創建的物件。

演示如何通過連接到 `Class.Instance.AncestryChanged` 事件來檢測實例的祖先變化。

ChangingPart 的 Parent 隨著時間的推移而設置為不同的值。部分的父級是該部分的祖先，因此每當它變更時，`Class.Instance.AncestryChanged` 事件就會觸發。

物件的 `Class.Instance.Parent` 屬性或其祖先之一被更改時觸發。

此事件包括兩個參數：`child` 指向實際更改了 `Class.Instance.Parent` 的 `Class.Instance`，而 `parent` 指向此實例的新的 `Class.Instance.Parent`。

你可以使用此事件跟蹤 Studio 中實例的刪除情況，例如在資源管理器中進行手動刪除或通過插件進行刪除。如果需要檢測何時通過 `Class.Instance:Destroy()` 毀掉實例，請改用 `Class.Instance.Destroying` 事件。

Instance.AncestryChanged

child

其 `Class.Instance.Parent` 已更改的 `Class.Instance`。

parent

其 `Class.Instance.Parent` 被更改的 `Class.Instance` 的新 `Class.Instance.Parent`。

物件的 `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` 時觸發。

這段程式碼會在物件從

工作空間中移除時，印出其名稱：

當子項從此 `Class.Instance` 中移除後觸發。

移除是指對象的父項從此 `Class.Instance` 更改為其他內容，而不再是此 `Class.Instance`。注意，當子項被銷毀（使用 `Class.Instance:Destroy()`）時此事件也會觸發，因為銷毀函數將對象的父項設置為 `nil`。

此事件僅對 `Class.Instance` 的直接子項有效。要捕捉所有後代的事件，請使用 `Class.Instance.DescendantRemoving`。

另見 `Class.Instance.ChildAdded`。

Instance.ChildRemoved

當一個子物件從此 `Class.Instance` 中移除後觸發。

以下範例會打印任何被添加到

工作空間的物件名稱:

此事件在一個後代被添加到 `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` 的一個子項被移除之前立即觸發。

此範例演示了在使用即時信號行為時，銷毀的實例在連接的函數暫停之前將保持在原位。

'此範例演示了當使用延遲信號行為時，

實例會在信號觸發之前被銷毀。'

在連接的函數尚在使用 `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` 事件是有問題的，因為腳本
將在回調被調用之前被銷毀（這意味著它不會執行）。

在 Studio 中刪除 `Class.Instance` 時，例如通過
 [Explorer](/studio/explorer) 手動刪除或通過插件，
`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` 時，將觸發此事件。

Instance.childAdded

此方法將標記應用於該實例，若該標記已應用將不會有任何效果。成功地添加標記將觸發由 `Class.CollectionService:GetInstanceAddedSignal()` 創建的信號。

##### 警告

- 客戶端添加的實例標記將被丟棄，如果伺服器稍後對該實例添加或移除標記，因為伺服器將所有標記一起複製並覆蓋先前的標記。

- 標記實例時，通常會使用某些資源來賦予標記其功能，例如事件連接或表格。為了防止內存泄漏，當標記不再需要時，進行清理（斷開連接，設置為 `nil` 等）是個好主意。在呼叫 `Class.Instance:RemoveTag()`、呼叫 `Class.Instance:Destroy()` 或在連接到 `Class.CollectionService:GetInstanceRemovedSignal()` 返回的信號中的函數時執行此操作。

Instance:AddTag

此方法銷毀實例的所有子項目和後代。

```
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` 的實例。

演示如何使用 `Class.Instance:Destroy()` 函數銷毀一個零件。

這個函數是正確處理不再需要的物件的方法。

將 `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()`。

返回 `Class.Instance` 的第一個祖先，其 `Class.Instance.Name` 等於給定的名稱。

此方法向上工作，意味著它從實例的直接 `Class.Instance.Parent` 開始，向上工作到 `Class.DataModel`。如果沒有找到匹配的祖先，則返回 `nil`。

以下代碼片段將找到名為 `Car` 的對象的第一個祖先。

```
local car = object:FindFirstAncestor("Car")
```
有關查找特定類別的祖先的此方法的變體，請參見 `Class.Instance:FindFirstAncestorOfClass()` 和 `Class.Instance:FindFirstAncestorWhichIsA()`。

Instance:FindFirstAncestor

name

返回 `Class.Instance` 的第一個祖先，其 `Class.Instance.Name` 等於給定的名稱。

返回 `Class.Instance` 的第一個祖先，其 `Class.Object.ClassName` 等於給定的 className。

此方法向上工作，意味著它從實例的直接 `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.Instance` 的第一個祖先，其 `Class.Object.ClassName` 等於給定的 className。

返回 `Class.Instance` 的第一個祖先，對於給定的 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

返回 `Class.Instance` 的第一個祖先，對於給定的 className， `Class.Object:IsA()` 返回 true。

以下將在工作區中尋找名為"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` 的屬性相同。使用點運算符時，如果它們共享名稱，則屬性優先於子項。

在以下示例中，將 `Class.Folder` 名稱為 `Color` 的資料夾添加到 `Class.Part` 中，該部分也具有 `Class.Part.Color` 屬性。請注意，`part.Color` 指的是 `Datatype.Color3` 屬性值，而不是子項 `Class.Folder` 實例。使用 `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

recursive

返回具有給定名稱的 `Class.Instance` 的第一個子物件。

返回 `Class.Instance` 的第一個子項，其 `Class.Object.ClassName|ClassName` 等於給定的 `className`。與 `Class.Instance:FindFirstChildWhichIsA()` 不同，此方法僅返回與 `className` 匹配的對象，忽略類別繼承。如果沒有找到匹配的子項，則此方法返回 `nil`。

Instance:FindFirstChildOfClass

返回 `Class.Instance` 的第一個子物件，其 `Class.Object.ClassName|ClassName` 等於給定的類別名稱。

返回 `Class.Instance` 的第一個子項，對於給定的 className，`Class.Object:IsA()` 返回 true。

如果沒有找到匹配的子項，此方法返回 `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

返回 `Class.Instance` 的第一個子物件，對於給定的 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

返回與實例相關的 `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("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

返回包含所有實例子物件的數組。

返回 Roblox 內部使用的調試 ID 的編碼字符串。注意：

- 該項是受保護的。在 `Class.Script` 或 `Class.LocalScript` 中嘗試使用會導致錯誤。
- 調試 ID 是用於調試過程中的 ID。它允許調試器在應用程序處理每條指令之前讀取它。 Roblox 中的所有物件都像過程一樣運行，每次都執行可根據需要進行調試的指令（或「代碼」）。
- 這對於需要區分類似物件的插件（例如分享同一名稱的物件）可能會有所幫助。

Instance:GetDebugId

scopeLength

返回 Roblox 內部使用的調試 ID 的編碼字符串。

GetDescendants 通常用於對所有子孫物件進行某些操作，這些物件是特定類型的物件。這個示例中的程式碼使用 GetDescendants 和 `Class.Instance:IsA()` 來找到工作區中的所有部件並將它們變成綠色。

此物件方法返回一個數組，包含該物件的所有後代。與 `Class.Instance:GetChildren()` 不同，此方法查找該物件的每個子物件，每個那些子物件的子物件，依此類推。

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

此方法返回指定屬性的樣式或明確修改的值，或者如果尚未進行樣式/修改則返回默認屬性值。這與直接訪問屬性值（例如 `[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

指定屬性的樣式或明確修改的值，或者如果尚未進行樣式/修改則返回默認屬性值。

返回指定屬性的樣式或明確修改的值，或者如果尚未進行樣式/修改則返回默認屬性值。

此方法返回了一個事件，行為完全類似 `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` 事件，不過它僅在給定樣式屬性更改時觸發。通常建議使用此方法，而不是與檢查屬性名稱的函數連接到 `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`。對於同一物件的後續調用將返回相同的事件。

注意，該事件不會將任何參數傳遞給連接的函數，因此必須在腳本中直接讀取更改屬性的值。

```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:GetStyledPropertyChangedSignal("AnchorPoint"):Connect(stylePropertyChanged)
```

Instance:GetStyledPropertyChangedSignal

property

要監聽變更的樣式屬性的名稱。

在給定樣式屬性更改時觸發的事件。

此方法返回應用於給定實例的標籤的數組，格式為字符串。你可以在工作室中 [屬性](/studio/properties) 窗口或在運行時使用 `Class.Instance:AddTag()|AddTag()` 來添加標籤。

當你想對實例上多個標籤做某些操作時，此方法非常有用。然而，使用此方法檢查單個標籤的存在性效率較低；相反，使用 `Class.Instance:HasTag()|HasTag()` 來檢查特定標籤。

Instance:GetTags

獲取應用於實例的所有標籤的數組。

此方法返回 `true`，如果提供的標籤已被添加到該物件。你可以在工作室中 [屬性](/studio/properties) 窗口或在運行時使用 `Class.Instance:AddTag()|AddTag()` 來添加標籤。

Instance:HasTag

檢查實例是否具有給定的標籤。

演示如何確定一個實例是否是另一個實例的祖先，使用 `Class.Instance:IsAncestorOf()`

Workspace 和 SpawnLocation 是 SpawnLocation 的貼圖的祖先。

Workspace 是 SpawnLocation 的祖先。

SpawnLocation 及其貼圖是 Workspace 的後裔，而不是祖先。

Decal 是 SpawnLocation 的後裔，而不是祖先。

如果 `Class.Instance` 是給定後代的祖先，則返回 true。

如果物件的 `Class.Instance.Parent` 或其父物件的 `Class.Instance.Parent` 設置為 `Class.Instance`，則視為該物件的祖先。

另請參見 `Class.Instance:IsDescendantOf()`。

Instance:IsAncestorOf

如果 `Class.Instance` 是給定後代的祖先，則為 true。

如果 `Class.Instance` 是給定後代的祖先，則返回 true。

如果 `Class.Instance` 是給定祖先的後代，則返回 true。

注意，`IsDescendantOf()` 不能用 `nil` 參數來檢查物件是否已被移除。

另請參見 `Class.Instance:IsAncestorOf()`。

Instance:IsDescendantOf

ancestor

如果 `Class.Instance` 是給定祖先的後代，則為 true。

如果 `Class.Instance` 是給定祖先的後代，則返回 true。

此方法表示特定屬性是否已從代碼實例化的默認值進行修改。如果在通過代碼新創建的實例上調用（`Datatype.Instance.new()`），則此方法將返回 `false`。如果在通過Studio工作流程新創建的對象上調用，例如 [Explorer](/studio/explorer) 窗口插入，結果可能會有所不同。

例如，查詢通過 [Explorer](/studio/explorer) 插入的 `Class.TextLabel.BackgroundColor3|BackgroundColor3` 屬性將返回 `true`，但查詢通過 `Datatype.Instance.new()` 創建的 `Class.TextLabel` 的相同屬性將返回 `false`，假設對其 `Class.TextLabel.BackgroundColor3|BackgroundColor3` 沒有進行其他更改。

請注意，如果此方法返回 `true`，則樣式將**不**影響該屬性，因為明確修改屬性優先於對其進行樣式處理。要將屬性重置為其代碼實例化的默認值並允許對其進行樣式處理，請使用 `Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()`。


Instance:IsPropertyModified

布林值，指示該屬性是否已從其代碼實例化的默認值進行修改。


如果指定屬性中存儲的值不等於代碼實例化的默認值，則返回 `true`。


以下代碼示範了如何在被移除後，將一個部件重新添加到數據模型中：

此方法將對象的 `Class.Instance.Parent` 設置為 `nil`，並對其所有後代執行相同操作。

如果在被移除之前對該對象進行了引用，則可以在以後的某個時候檢索該對象。

Instance:Remove

將物件的 `Parent` 設置為 `nil`，並對其所有後代執行相同操作。

此方法從實例中移除標籤。如果物件沒有該標籤，則不會引發錯誤。成功移除標籤將觸發由 `Class.CollectionService:GetInstanceRemovedSignal()` 創建的信號，並附上給定標籤。

注意，標記實例時，通常會使用某些資源來賦予標記其功能，例如事件連接或表格。為了防止內存泄漏，當不再需要標記時，進行清理（斷開連接，設置為 `nil` 等）是個好主意。

Instance:RemoveTag

將屬性重置為其默認值。例如，在 `Class.TextLabel` 上呼叫 `ResetPropertyToDefault("Rotation")` 相當於將其 `Class.TextLabel.Rotation|Rotation` 設置為 `0`（該屬性的默認值）。此方法可用於確保樣式將覆蓋此屬性的默認值。

Instance:ResetPropertyToDefault

此方法將具有給定名稱的屬性設置為給定值。如果提供的值為 `nil`，則屬性將被移除，因為默認情況下返回 `nil`。

例如，以下代碼片段將實例的 `InitialPosition` 屬性設置為 `Datatype.Vector3|Vector3.new(0, 10, 0)`：

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

local part = Workspace.Part
part:SetAttribute("InitialPosition", Vector3.new(0, 10, 0))
```

##### 限制

命名要求和限制：

- 名稱只能使用字母數字字符。
  - 您也可以包含句點、連字符、斜杠和底線。
- 不允許空格或唯一符號（如 @、~、！）。
- 字符串必須不超過 100 個字符。
- 除非調用者是 Roblox 核心腳本，否則名稱不允許以 **RBX** 開頭（保留給 Roblox）。

當嘗試將屬性設置為不受支持的類型時，將引發錯誤。

##### 另見

- `Class.Instance:GetAttribute()`，返回已分配給給定屬性名稱的值。
- `Class.Instance:GetAttributes()`，返回與實例的每個屬性相關的鍵值對字典。

Instance:SetAttribute

value

將具有給定名稱的屬性設置為給定值。

以下代碼會等待一個名為 "Part" 的實例被添加到

    Workspace。

返回具有給定名稱的 `Class.Instance` 的子項。如果子項不存在，則會直到該子項存在為止暫停當前線程。如果指定了 `timeOut` 參數，則此方法將在指定的秒數後超時，並返回 `nil`。

##### 主要用法

`Class.Instance:WaitForChild()|WaitForChild()` 在客戶端運行的代碼中極為重要，特別是在 `Class.LocalScript` 中。Roblox 引擎不保證對象從服務器到客戶端的復制時間或順序。此外，如果體驗的 `Class.Workspace.StreamingEnabled` 設置為 true，則遠離玩家角色的 `Class.BasePart|BaseParts` 可能不會傳輸到客戶端，這可能會導致在索引尚不存在的對象時腳本出錯。

##### 注意事項

- 在調用時，如果具有給定名稱的子項存在，則此方法不會暫停。
- `Class.Instance:FindFirstChild()` 是 `Class.Instance:WaitForChild()|WaitForChild()` 的更高效替代方法，適用於假設存在的對象。
- 如果該方法的調用超過 5 秒而不返回，並且沒有指定 `timeOut` 參數，則會向輸出打印警告，表示該線程可能會永久暫停。

Instance:WaitForChild

childName

timeOut

返回具有給定名稱的 `Class.Instance` 的子物件。如果子物件不存在，則將使當前線程暫停，直到它存在。

子物件函數返回該物件的子物件數組。

Instance:children

Instance:clone

Instance:destroy

Instance:findFirstChild

Instance:getChildren

Instance:isDescendantOf

Instance:remove

Instance

此屬性判斷在經驗發佈或保存時，或在呼叫 `Class.Instance:Clone()|Clone()` 時，該實例是否應包含在內。如果直接在實例上呼叫 `Class.Instance:Clone()|Clone()`，則如果該實例 **不是** `Class.Instance.Archivable|Archivable`，將返回 `nil`。

在 Studio 中使用 **複製** 或 **複製**/**粘貼** 選項來複製物件將忽略其自身的 `Class.Instance.Archivable|Archivable` 屬性，並將其設置為 `true`。

```
local part = Instance.new("Part")
print(part:Clone())  --> Part
part.Archivable = false
print(part:Clone())  --> nil
```

Instance.Archivable

判斷 `Class.Instance` 及其後代是否可以使用 `Class.Instance:Clone()` 進行複製，以及是否可以保存/發佈。

此實例內允許用於腳本的功能集。要使功能生效，必須啟用 `Class.Instance.Sandboxed` 屬性。

此屬性由實驗性功能使用。詳細資訊請參見 [腳本功能](/scripting/capabilities)。

Instance.Capabilities

此容器內允許用於腳本的功能集。

一個非唯一的 `Class.Instance` 識別符。名稱用於保持物件層級的組織，並允許腳本訪問特定物件。實例的名稱不得超過 100 個字符。

物件的名稱通常用於通過數據模型層級以以下方法訪問物件：

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

local baseplate = Workspace.Baseplate
local baseplate = Workspace["Baseplate"]
local baseplate = Workspace:FindFirstChild("BasePlate")
```
為了使用點運算子 (`.`) 使物件可訪問，其名稱必須以底線或字母開頭，其餘名稱只能包含字母、數字或底線（無其他特殊字符）。如果物件的名稱不符合此語法，則無法使用點運算子訪問並且 Luau 不會將其名稱解釋為識別符。

如果多個同名物件為兄弟物件，任何對該名稱索引物件的嘗試僅會返回其中一個物件，類似於 `Class.Instance:FindFirstChild()`，但不一定是所需的物件。如果需要通過代碼訪問特定物件，建議給它一個唯一的名稱或保證其兄弟中沒有其他物件共享相同的名稱。

另請參見 `Class.Instance:GetFullName()` 獲取包括物件層級在內的全名。

Instance.Name

一個非唯一的 `Class.Instance` 識別符。

`Instance` 是 Roblox 類別層級中所有類別的基礎類別，可以作為 `Class.DataModel` 樹的部分。

/reference/engine/classes/GeometryService.yaml

GeometryService

概要

屬性

方法

活動

屬性

方法

活動

此頁面