Instance

非推奨を表示

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

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

概要

コンストラクタ

コンストラクタ

new

新しい Instance のタイプ className を作成します。

オブジェクトの Parent が設定されると、Luau は、レプリケーション、レンダリング、および物理のために、さまざまなプロパティの変更を聞きます。性能のために、この構造の Class.Instance.Parent|Parent プロパテ


-- 新しいインスタンスの親を設定します (おすすめ)
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 をコピーしません。

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

パラメータ

existingInstance: Instance

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