一個 `Class.Texture` 物件將重複的影像材質應用於父物件 `Class.BasePart` 的面上。受影響的面取決於 `Class.Texture.Face|Face` 屬性。與 `Class.Decal|Decals` 不同，`Class.Texture` 應用的材質在父物件 `Class.BasePart` 調整大小時會重複，重複材質的大小由 `Class.Texture.StudsPerTileU|StudsPerTileU` 和 `Class.Texture.StudsPerTileV|StudsPerTileV` 屬性決定。

應用的影像材質由其 `Class.Texture.ColorMapContent|ColorMapContent` 屬性決定。關於如何上傳影像的詳細資訊，請參見 [資產管理](/projects/assets#asset-management)。

如需更多資訊，請參閱 [材質和貼圖](/parts/textures-decals)。另請參見：

- `Class.Decal` 用於非重複的表面影像。
- `Class.MeshPart.TextureContent` 將影像材質應用於 `Class.MeshPart`。
- `Class.SurfaceGui` 將 `Class.ImageLabel` 或 `Class.ImageButton` 應用於體驗中的 3D 物件。

Texture

此屬性決定渲染的材質在水平軸上的偏移距離，以 studs 為單位，如下圖所示
[這裡](/parts/textures-decals#offset-textures)。

另請參閱 `Class.Texture.OffsetStudsV|OffsetStudsV`。

Texture.OffsetStudsU

決定渲染紋理的水平坐標在 studs 中的偏移量。

此屬性決定了渲染的材質在垂直軸上的偏移距離，以 studs 為單位，如此視覺化 [這裡](/parts/textures-decals#offset-textures)。

另請參見 `Class.Texture.OffsetStudsU|OffsetStudsU`。

Texture.OffsetStudsV

決定渲染紋理的垂直坐標在 studs 中的偏移量。

設置 `Class.Texture` 應用的圖像在水平上的大小，單位為 studs。

該屬性的較大值將導致 `Class.Texture` 看起來更大，重複的頻率較低。與 `Class.Decal|Decals` 不同，重複圖像的大小不受 `Class.BasePart` 尺寸的影響。相反，調整 `Class.BasePart` 的大小僅會增加紋理重複的次數。

請注意，該屬性可以設置為非常低的值，但不能為零。還要注意，水平/垂直區分與父 `Class.BasePart` 軸相對，因此 `Class.Texture` 將隨著 `Class.BasePart` 旋轉。

另請參見 `Class.Texture.StudsPerTileV|StudsPerTileV`。

Texture.StudsPerTileU

設置 `Class.Texture` 應用的圖像在水平上的大小，單位為 studs。

設置 `Class.Texture` 應用的圖像在垂直上的大小，單位為 studs。

該屬性的較大值將導致 `Class.Texture` 看起來更大，重複的頻率較低。與 `Class.Decal|Decals` 不同，重複圖像的大小不受 `Class.BasePart` 尺寸的影響。相反，調整 `Class.BasePart` 的大小僅會增加紋理重複的次數。

請注意，該屬性可以設置為非常低的值，但不能為零。還要注意，水平/垂直區分與父 `Class.BasePart` 軸相對，因此 `Class.Texture` 將隨著 `Class.BasePart` 旋轉。

另請參見 `Class.Texture.StudsPerTileU|StudsPerTileU`。

Texture.StudsPerTileV

設置 `Class.Texture` 應用的圖像在垂直上的大小，單位為 studs。

將重複的影像材質應用於父級 `Class.BasePart` 的面上。

以下代碼將在地面上創建一個 `Part`，並在其頂面應用一個 `Decal`。
當某物碰到該部件時，例如當玩家走過它時，應用於貼圖的材質將會改變，並播放聲音。


以下代碼將創建一個透明的 `Part`，並使用 `TweenService` 和 `Class.Decal.Transparency` 使其漸變進出。


`Class.Decal` 物件將影像紋理應用於父 `Class.BasePart` 的一個面。受到影響的面取決於 `Class.Decal.Face|Face` 屬性，而貼圖的大小則依賴於該面的大小。

所應用的影像紋理由其 `Class.Decal.ColorMapContent|ColorMapContent` 屬性決定。關於如何上傳影像的詳細資訊，請參閱 [資產管理](/projects/assets#asset-management)。

欲了解更多資訊，請查看 [材質與貼圖](/parts/textures-decals)。另請參考：

- `Class.Texture` 用於重複的表面影像。
- `Class.MeshPart.TextureContent` 將影像紋理應用於 `Class.MeshPart`。
- `Class.SurfaceGui` 將 `Class.ImageLabel` 或 `Class.ImageButton` 應用於體驗中的 3D 物件。

Decal

當設置為 `true` 時，貼圖的圖像資產有資格通過自動資產捕獲系統進行自動本地化。`Class.LocalizationService` 使用此屬性來確定貼圖的 `Class.Decal.ColorMapContent|ColorMapContent` 是否應該被捕獲並可能被本地化版本替換。

此屬性僅適用於非 PBR 貼圖。如果設置了任何 PBR 地圖 (`Class.Decal.NormalMapContent|NormalMapContent`、`Class.Decal.RoughnessMapContent|RoughnessMapContent`、`Class.Decal.MetalnessMapContent|MetalnessMapContent` 或 `Class.Decal.EmissiveMaskContent|EmissiveMaskContent`)，則自動本地化捕獲會被抑制，以避免不一致的渲染。

Decal.AutoLocalize

當設置為 `true` 時，貼圖的圖像資產有資格自動
進行本地化捕獲。

此範例程式碼在工作區中創建一個 `Decal`，並在使用 `Class.TweenService` 的迴圈中更改其 `Class.Decal.Color3` 屬性。

`Datatype.Color3` 的貼圖色調。請注意，此屬性
僅設置貼圖的 **色調** 而不是顏色；除非與 `Class.Decal`
關聯的圖像最初是純白色，否則無法使用此屬性自由更改顏色。

Decal.Color3

此屬性接受一個內容 ID 來決定表面的顏色和不透明度。此紋理有時稱為 **反照率** 紋理。

Decal.ColorMap

決定表面顏色和不透明度的內容 ID。

此屬性接受一個 `Datatype.Content` 對象來決定表面的顏色和
不透明度。此紋理有時稱為 **反照率** 紋理。

Decal.ColorMapContent

`Datatype.Content` 對象，決定表面的顏色和不透明度。

此屬性接受一個 `Datatype.Content` 對象，用於確定表面的表觀發光度。發光遮罩是一個灰階圖像，其中黑色像素對應於無發光度，白色像素對應於完全發光度。默認為空內容，在這種情況下，貼圖不會發光。

發光貢獻會添加到表面的總照明貢獻中，並且總和會乘以來自 `Class.Decal.ColorMapContent|ColorMapContent` 的反照率紋理（如果提供）。使用 `Class.Decal.EmissiveStrength|EmissiveStrength` 和 `Class.Decal.EmissiveTint|EmissiveTint` 來控制發光的亮度和顏色。

分配發光遮罩使 `Class.Decal` 成為物理基渲染 (PBR) 表面。

Decal.EmissiveMaskContent

`Datatype.Content` 對象，用於確定表面的發光度。

此值是一個乘數，用於控制 `Class.Decal.EmissiveMaskContent|EmissiveMaskContent` 在表面上的發光貢獻強度。默認為 `1`。負值被視為 `0`，而 `0` 的值會關閉發光。

如果最終的發光貢獻超過支持的動態範圍，則會被限制，這可能會使發光區域在較大強度值下顯示為完全白色。由於此值是乘數，避免限制的最大值取決於其他貢獻值，包括 `Class.Decal.EmissiveTint|EmissiveTint`、`Class.Decal.ColorMapContent|ColorMapContent` 和綜合照明貢獻。

Decal.EmissiveStrength

此值是一個 `Datatype.Color3`，用於著色 `Class.Decal.EmissiveMaskContent|EmissiveMaskContent` 的發光貢獻。默認為白色，這樣發光顏色不會改變。每個組件的值被限制在 `0` 和 `1` 之間，黑色會關閉發光。

Decal.EmissiveTint

作為貼圖的 `Class.Decal.Transparency|Transparency` 屬性的乘數。效果僅對 `Class.Players.LocalPlayer|LocalPlayer` 可見，並不會複製到伺服器。

當此屬性設置為 `1` 時，`Class.Decal` 將完全不可見，無論其原始透明度如何。當設置為 `0` 時，貼圖的渲染透明度將與 `Class.Decal.Transparency|Transparency` 值匹配。

Decal.LocalTransparencyModifier

作為貼圖的 `Class.Decal.Transparency|Transparency` 屬性的乘數。效果僅對本地玩家可見。

此屬性接受一個內容 ID，用於確定應用於表面的金屬度地圖。金屬度地圖控制表面在每個點的金屬外觀，混合介電質（非金屬）和金屬對光的反應。默認為空內容，在這種情況下不應用金屬度地圖。

分配法線、粗糙度、金屬度或發光地圖使 `Class.Decal` 成為物理基渲染 (PBR) 表面。要從 `Datatype.Content` 對象分配此地圖，請使用 `Class.Decal.MetalnessMapContent|MetalnessMapContent`。

Decal.MetalnessMap

確定表面的金屬度地圖的內容 ID。

此屬性接受一個 `Datatype.Content` 對象，用於確定應用於表面的金屬度地圖。金屬度地圖控制表面在每個點的金屬外觀，混合介電質（非金屬）和金屬對光的反應。默認為空內容，在這種情況下不應用金屬度地圖。

分配法線、粗糙度、金屬度或發光地圖使 `Class.Decal` 成為物理基渲染 (PBR) 表面。

Decal.MetalnessMapContent

`Datatype.Content` 對象，用於確定表面的金屬度地圖。

此屬性接受一個內容 ID，用於確定應用於表面的法線地圖。法線地圖擾動用於照明計算的表面法線，添加細節的外觀，例如凹凸和溝槽，而不改變底層幾何形狀。默認為空內容，在這種情況下不應用法線地圖。

分配法線、粗糙度、金屬度或發光地圖使 `Class.Decal` 成為物理基渲染 (PBR) 表面。要從 `Datatype.Content` 對象分配此地圖，請使用 `Class.Decal.NormalMapContent|NormalMapContent`。

Decal.NormalMap

確定表面的法線地圖的內容 ID。

此屬性接受一個 `Datatype.Content` 對象，用於確定應用於表面的法線地圖。法線地圖擾動用於照明計算的表面法線，添加細節的外觀，例如凹凸和溝槽，而不改變底層幾何形狀。默認為空內容，在這種情況下不應用法線地圖。

分配法線、粗糙度、金屬度或發光地圖使 `Class.Decal` 成為物理基渲染 (PBR) 表面。

Decal.NormalMapContent

`Datatype.Content` 對象，用於確定表面的法線地圖。

此屬性控制貼圖紋理的旋轉角度（以度為單位）。旋轉是以順時針方向應用於 UV 坐標。

Decal.Rotation

此屬性接受一個內容 ID，用於確定應用於表面的粗糙度地圖。粗糙度地圖控制表面在每個點的粗糙或光滑外觀，這反過來又決定了其反射的清晰或模糊程度。默認為空內容，在這種情況下不應用粗糙度地圖。

分配法線、粗糙度、金屬度或發光地圖使 `Class.Decal` 成為物理基渲染 (PBR) 表面。要從 `Datatype.Content` 對象分配此地圖，請使用 `Class.Decal.RoughnessMapContent|RoughnessMapContent`。

Decal.RoughnessMap

確定表面的粗糙度地圖的內容 ID。

此屬性接受一個 `Datatype.Content` 對象，用於確定應用於表面的粗糙度地圖。粗糙度地圖控制表面在每個點的粗糙或光滑外觀，這反過來又決定了其反射的清晰或模糊程度。默認為空內容，在這種情況下不應用粗糙度地圖。

分配法線、粗糙度、金屬度或發光地圖使 `Class.Decal` 成為物理基渲染 (PBR) 表面。

Decal.RoughnessMapContent

`Datatype.Content` 對象，用於確定表面的粗糙度地圖。

此屬性決定貼圖的光澤度。它接受一個介於 `0` 和 `1` 之間的值，其中 `1` 為「完全光澤」。

Decal.Shiny

已棄用的屬性，之前設置了貼圖的光澤度。

設置鏡面反射度，即表面對光照的反應。

Decal.Specular

已棄用的屬性，之前設置了貼圖的鏡面反射度。

將應用於 `Class.Decal` 的圖像的內容 ID。

Decal.Texture

由 `Class.Decal` 顯示的紋理內容。支持 [資產 URI](/projects/assets#asset-uris) 和 `Class.EditableImage` 對象。

Decal.TextureContent

由 `Class.Decal` 顯示的紋理內容。

由引擎管理，無法從腳本訪問。`Datatype.Content`，持有貼圖的壓縮運行時紋理數據。當 `Class.Decal` 是物理基渲染 (PBR) 表面時，引擎將其顏色、法線、粗糙度、金屬度和發光地圖打包到單個紋理包資產中並在此處引用。默認為空內容。

Decal.TexturePackContent

引擎管理的 `Datatype.Content`，存儲 PBR 貼圖的壓縮運行時紋理包數據。

確定 `Class.Decal` 的透明度，`0` 為完全不透明，`1` 為完全透明。

請注意，`Class.Decal.LocalTransparencyModifier|LocalTransparencyModifier` 作為此透明度級別的 **乘數**，應在貼圖的透明度可能被其他腳本更改時使用。

Decal.Transparency

此屬性控制 UV 坐標的平移。`Datatype.Vector2.X|X` 值 (**U**&nbsp;偏移) 和 `Datatype.Vector2.Y|Y` 值 (**V**&nbsp;偏移) 在紋理映射過程中添加到每個相應的 UV 坐標。

Decal.UVOffset

通過在紋理映射之前添加偏移來移動 UV 坐標。

此屬性控制應用於水平和垂直坐標的縮放。`Datatype.Vector2.X|X` 值 (**U**&nbsp;縮放) 和 `Datatype.Vector2.Y|Y` 值 (**V**&nbsp;縮放) 在紋理映射過程中乘以每個相應的 UV 坐標。

Decal.UVScale

通過乘以縮放因子來拉伸或壓縮 UV 坐標。

此屬性確定在 `Class.BasePart` 的同一 `Class.Decal.Face|Face` 上渲染貼圖的順序。較低的值優先渲染，因此具有較高 `ZIndex` 的貼圖會在較低 `ZIndex` 的貼圖之上渲染。

如果您不確定將來是否需要在兩個已存在的貼圖之間分層貼圖，請使用較大的 `ZIndex` 值之間的間隔，例如 `10` 或 `100`，以確保未來貼圖之間有空間。

Decal.ZIndex

確定當多個貼圖分配到同一面時的渲染順序。

將影像紋理應用於父 `Class.BasePart` 的一個面。

`Class.FaceInstance` 是一個抽象類別，`Class.Decal` 和
`Class.Texture` 類別都從這個類別繼承。

FaceInstance

設定物件出現在父級 `Class.BasePart` 的哪一面。

FaceInstance.Face

一個抽象類別，`Class.Decal` 和 `Class.Texture` 類別從此繼承。


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

無法直接創建根 `Instance` 物件，但特殊的
`Datatype.Instance.new()` 構造函數通過代碼創建物件，
以類別名稱作為參數並返回創建的物件。


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

ChangingPart 的 Parent 隨著時間設置為不同的值。部分的父項是該部分的祖先，因此每當發生變化時，`Class.Instance.AncestryChanged` 事件將被觸發。

當此實例被重新設置父項或其任何祖先被重新設置父項時觸發。

您可以使用此事件來跟踪 Studio 中實例的刪除，
例如在 Explorer 中手動刪除或通過插件刪除。如果您需要
檢測使用 `Class.Instance:Destroy()` 銷毀實例的時候，
請使用 `Class.Instance.Destroying` 事件。


Instance.AncestryChanged

child

其 `Class.Instance.Parent|Parent` 屬性更改的實例，
可以是此實例或更遠的祖先，**不**一定是處理程序連接的實例。


parent

當此對象或其祖先的 `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

每當 `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` 的對象。注意，當子項被銷毀（使用
`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()` 銷毀之前立即觸發（或延遲到之後觸發）。


演示 `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.BasePart|BaseParts` 從 `Class.Model` 中降下來的物件：

```
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` 的第一個祖先，該祖先的 `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.Object.ClassName`。


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


返回 `Class.Instance` 的第一個祖先，該祖先的 `Class.Object:IsA()` 對給定的 className 返回 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` 的第一個祖先，該祖先的 `Class.Object:IsA()` 對給定的 className 返回 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` 的屬性相同。
使用點運算符時，如果它們共享名稱，屬性將優先於子物件。

在以下示例中，將一個名為 `Color` 的 `Class.Folder` 添加到 `Class.Part`，
該 `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` 的第一個子物件。


Instance:findFirstChild

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


Instance:FindFirstChildOfClass

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


返回 `Class.Instance` 的第一個子物件，該子物件的 `Class.Object:IsA()` 對給定的 className 返回 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` 的第一個子物件，該子物件的 `Class.Object:IsA()` 對給定的 className 返回 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

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


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

返回包含實例所有後代的數組。


Instance

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


概要