Instance

顯示已棄用項目

*此內容是使用 AI(Beta 測試版)翻譯,可能含有錯誤。若要以英文檢視此頁面,請按一下這裡

Instance 數據類型保持對 Instance 對象的生成器。

概要

建構子

建構子

new

創建一個新的 Instance 類型 className 。抽象類和服務無法使用此建造器創建。

注意,當對象的 Parent 被設設定時, Luau 會聆聽復製、渲染和物理的各種不同變更的屬性。為了效能原因,建議在創建新對象時設置實個體、實例的 Parent 屬性 last ,而不是指定此建造器的第二個參數 ( parent )。


local Workspace = game:GetService("Workspace")
-- 設定新實個體、實例的父親最後(建議)
local part = Instance.new("Part")
part.Position = Vector3.new(0, 10, 0)
part.Parent = Workspace
-- 在建造器中設置新實個體、實例的父親(已禁止)
local part = Instance.new("Part", Workspace)
part.Position = Vector3.new(0, 10, 0)

參數

className: string

要創建立、創作的新實例名稱。

parent: Instance

可選擇的對象來親和新實例。不建議用於性能原因(參見上面的說明)。

fromExisting

創建一個新對象,具有與現有對物件相同的類型和屬性值。在大多數情況下,使用 Instance:Clone() 更適合,但此建造器在實現低級圖形庫或系統時有用。

這個建造者和 Instance:Clone() 方法之間存在兩個行為差異:

  • 此建造者不會複製任何已傳給現有對物件的子孫 Instances 父親。

  • 此建造者將返回新對象,即使現有對象已設為 Instance.Archivable 設為 false

參數

existingInstance: Instance

現有的 Instance 來複製屬性值。