Instance

非推奨を表示

*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

Instance データ型は、Instance オブジェクトのコンストラクターを保持します。

概要

コンストラクタ

コンストラクタ

new

新しい Instance タイプの className を作成します。抽象クラスとサービスは、このコンストラクターで作成できません。

オブジェクトの Parent が設定されると、Luau はレプリケーション、レンダリング、物理のためのさまざまな異なるプロパティの変更を聞きます。パフォーマンスの理由により、このコンストラクターの 2番目の引数 ( parent ) を指定するのではなく、新しいオブジェクトを作成するときにインスタンスの 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() メソッドの間には、2つの行動の違いがあります：

  • このコンストラクタは、既存のオブジェクトに親和された子孫のいずれもコピーしません。Instances

  • このコンストラクタは、既存のオブジェクトが に設定されていても、新しいオブジェクトを返します。

パラメータ

existingInstance: Instance

既存の Instance からプロパティ値をコピーする。