Roblox インスタンスを保持および整理するための単純なコンテナ。`Class.Model` のような他のコンテナクラスとは異なり、フォルダは一般的に追加機能を提供しません。フォルダは、コンピュータファイルシステムのフォルダと同じように動作し、つまり相互に親になることもできます。

  #### UI 階層での使用

  UI 階層の各 `Class.Folder` は、独自の `Class.UILayout` （ `Class.UIListLayout` ,  `Class.UIGridLayout` ,  `Class.UIPageLayout` ,  `Class.UITableLayout` ）を定義したり、デフォルトの位置ベースのレイアウトを使用したりできます。たとえば、複数の `Class.Frame` 子供を持つ `Class.Folder` を設定し、それぞれ異なる `Class.UILayout` タイプを持つことができます。さらに、`Class.Folder` コンテンツは、`Class.UILayout` 兄弟の影響から除外されます。

Folder

Roblox インスタンスを保持および整理するための単純なコンテナ。

`Instance` は、`Class.DataModel` ツリーの一部である Roblox クラス階層のすべてのクラスのベースクラスです。

  直接ルート `Instance` オブジェクトを作成することはできませんが、特別な `Datatype.Instance.new()` コンストラクターはコードを介してオブジェクトを作成し、クラスの名前をパラメータとして取り、作成されたオブジェクトを返します。

Demonstrates detecting changes to an instance's ancestry by connecting to the `Class.Instance.AncestryChanged` event.

The ChangingPart's Parent is set to different values overtime. The parent of the part is the part's ancestor, so the `Class.Instance.AncestryChanged` event will fire whenever it changes.

オブジェクトの `Class.Instance.Parent` プロパティまたは祖先の 1 つが変更されると、炎が発生します。

  このイベントには、2つのパラメータが含まれています: `child` は、`Class.Instance` の `Class.Instance.Parent` が実際に変更されたものを参照し、`parent` は、このインスタンスの新しい `Class.Instance.Parent` を参照します。

  このイベントを使用して、Explorer での手動削除やプラグインを介した削除など、Studio でインスタンスの削除を追跡できます。インスタンスが `Class.Instance:Destroy()` を使用して破壊されたときに検出する必要がある場合は、代わりに `Class.Instance.Destroying` イベントを使用します。

Instance.AncestryChanged

child

変更された `Class.Instance` の whose `Class.Instance.Parent` は変更されました。

parent

その `Class.Instance.Parent` の新しい `Class.Instance` の `Class.Instance.Parent` が変更されました。

オブジェクトの `Class.Instance.Parent` プロパティまたは祖先の 1 つが変更されると、炎が発生します。

このイベントは、アトリビュートが `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` で変更されるたびに発火します。

This snippet prints the names of objects as they are added to the Workspace:

オブジェクトがこの `Class.Instance` に親化された後に発火します。

  この機能をクライアントで使用して、サーバーによって作成されたオブジェクトを検出するときは、これらのオブジェクトの子孫をインデックスするときに `Class.Instance:WaitForChild()` を使用する必要があります。これは、オブジェクトとその子孫が同時にサーバーからクライアントに複製されることは保証されていないためです。例えば:

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

  Workspace.ChildAdded:Connect(function(child)
  	-- Use WaitForChild() since descendants may not have replicated yet
  	local head = child:WaitForChild("Head")
  end)
  ```

  注: この機能は、`Class.Instance` の直接の子供にのみ作動します。すべての子孫をキャプチャする機能を使用するには、`Class.Instance.DescendantAdded` を使用します。

  参照してください `Class.Instance.ChildRemoved` 。

Instance.ChildAdded

オブジェクトがこの `Class.Instance` に親化された後に発火します。

This snippet prints the names of objects as they are removed from the
Workspace:

子供がこの `Class.Instance` から削除された後に発火します。

  削除は、オブジェクトの親がこの からこれ以外のものに変更されたときを指します。注: このイベントは、子供が破壊されたとき(`Class.Instance:Destroy()` を使用して)、破壊機能がオブジェクトの親を `nil` に設定するときにも発動します。

  この機能は、`Class.Instance` の直接の子供にのみ作動します。すべての子孫をキャプチャする機能を使用するには、`Class.Instance.DescendantRemoving` を使用します。

  参照してください `Class.Instance.ChildAdded` 。

Instance.ChildRemoved

子供がこの `Class.Instance` から削除された後に発火します。

This following example will print the name of any object that is added to the
Workspace:

このイベントは、子孫が `Class.Instance` に追加された後に発動します。

  すべての子孫に発射すると、オブジェクトを親にすると、このオブジェクトとすべての子孫が個別にイベントを発射します。

  If you're only concerned with the **直接の子供** of the `Class.Instance` , use `Class.Instance.ChildAdded` instead.

  参照してください `Class.Instance.DescendantRemoving` 。

Instance.DescendantAdded

descendant

子孫が `Class.Instance` に追加された後に発火します。

The following example prints the name of any descendant as it is being removed
from the Workspace:

このイベントは、親の **変更** が行われる直前に `Class.Instance` 発動し、 **後継者** インスタンスがもはや後継者ではなくなります。`Class.Instance:Destroy()|Destroy()` は、インスタンスの `Class.Instance.Parent|Parent` を `nil` に変更し、親の子孫にこのメソッドを呼ぶと、このイベントが発動します。

  このイベントは、子孫の削除の前に 発射されるため、このイベント発射時に親子孫の親は変更されません。子孫が親の直接の子供でもある場合、このイベントは より前に発動します。

  子孫に子供がいる場合、このイベントはまず子孫が発射し、その子孫を続けます。

  ##### 注意

  このイベントは、削除されている子孫オブジェクトで発動します。子孫の `Class.Instance.Parent|Parent` を別のものに設定しようとすると、失敗します。以下は、これを示す例です：

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

  Workspace.DescendantRemoving:Connect(function(descendant)
  	-- Do not manipulate the parent of the descendant in this function!
  	-- This event fires BECAUSE the parent was manipulated, and the change hasn't happened yet
  	-- Therefore, it is problematic to change the parent like this:
  	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` の後継者が削除される直前に即座に発火します。

This sample demonstrates how, when using Immediate signal behavior, an Instance being destroyed remains in place until the connected function yields.

This sample demonstrates how, when using Deferred signal behavior,
an Instance is destroyed before the signal fires.

接続された関数がまだ使用している間、`Class.Instance` はメモリから削除されることはありません。しかし、機能がどこかで引き出された場合、`Class.Instance` とその子孫は`nil` に親属することになります。

  `Class.Workspace.SignalBehavior` プロパティが `Enum.SignalBehavior.Immediate` に設定されている場合、このイベントは `Class.Instance` またはその祖先の 1つが `Class.Instance:Destroy()` で破壊される前にすぐに発動します。

  プロパティが に設定されている場合、このイベントは次の再開ポイントで発動し、それは またはその祖先の 1つが で破壊される後です。

  `Enum.SignalBehavior.Deferred|Deferred` 行動では、スクリプトを自分の`Class.Instance.Destroying`イベントに接続することが問題であり、コールバックが呼び出される前にスクリプトが破壊されるため (つまり実行されない)。

  Studio で `Class.Instance` を削除するとき、手動で [エクスプローラー](/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("Styled properties changed")
  end

  meterBar:StyledPropertiesChanged():Connect(stylePropertyChanged)
  ```

Instance.StyledPropertiesChanged

インスタンス上で任意のスタイルプロパティが変更されるたびに発火し、プロパティが `nil` に設定されている場合を含めます。

Instance.childAdded

このメソッドは、タグをインスタンスに適用し、タグがすでに適用されている場合は効果がありません。タグを成功裏に追加すると、指定されたタグで `Class.CollectionService:GetInstanceAddedSignal()` によって作成されたシグナルが発射されます。

  ##### 注意

  *   サーバーが後で、サーバーがすべてのタグを複製して前のタグを上書きするため、クライアント側に追加されたインスタンスのタグが削除されます。An instance's tags that were added client-side will be dropped if the server later adds or removes a tag on that instance because the server replicates all tags together and overwrites previous tags.

  *   インスタンスをタグ付けするとき、タグの機能を提供するために、例えばイベント接続またはテーブルが使用されるのは一般的です。メモリ漏れを防ぐには、タグがもう必要ないときにこれらをクリーンアップする (接続を切断し、`nil` に設定など) が良い考えです。これを行うには、`Class.Instance:RemoveTag()` 、`Class.Instance:Destroy()` 、または `Class.CollectionService:GetInstanceRemovedSignal()` によって返されたシグナルに接続された関数で、呼び出してください。

Instance:AddTag

インスタンスにタグを付与します。

この関数は、インスタンスの子供と孫すべてを破壊します。

  ```
  local part = Instance.new("Part")

  -- Add some sparkles
  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()` を使用します。たとえば、次のコードサンプルは、 から下にすべてを破壊します：

  ```
  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

この機能は、インスタンスのすべての子を破壊します。

Demonstrates cloning a model using `Class.Instance:Clone()`.

`Clone()` は、すべて `Class.Instance.Archivable|Archivable` でないインスタンスとすべての子孫のコピーを作成し、すべてのインスタンスを無視します。このメソッドでは、根インスタンスのコピーが返され、その `Class.Instance.Parent|Parent` は `nil` に設定されます。注: インスタンス自体が に設定されている場合、この関数は を返します。

  参照プロパティ (例: `Class.ObjectValue.Value`) がクローンインスタンスに設定された場合、コピーのプロパティの値はオリジナルの値に依存します:

  *   参照プロパティが **も** クローンされたインスタンスを参照している場合、コピーはコピーに参照します。
  *   参照プロパティが **クローンされなかったオブジェクトを参照している場合、コピーに同じ値が保持されます** 。

Instance:Clone

インスタンスとそのすべての子孫のコピーを作成し、`Class.Instance.Archivable|Archivable` ではないインスタンスを無視します。

Demonstrates destroying a Part using the `Class.Instance:Destroy()` function.

This function is the correct way to dispose of objects that are no longer required.

`Class.Instance.Parent` プロパティを `nil` に設定し、`Class.Instance.Parent` プロパティをロックし、すべての接続を切断し、すべての子供に `Destroy()` を呼び出します。この機能は、もはや必要ないオブジェクトを処分する正しい方法です。

  不要なオブジェクトの処分は重要であり、場所の不要なオブジェクトと接続は、時間経過により深刻なパフォーマンスの問題につながる可能性があるメモリを使用します。

  オブジェクトを呼び出した後のベストプラクティスとして、オブジェクト (またはその子孫) を参照するすべての変数を に設定します。これにより、コードがオブジェクトに関連するものにアクセスできなくなります。

  ```lua
  local part = Instance.new("Part")
  part.Name = "Hello, world"
  part:Destroy()
  -- これはしないでください：
  print(part.Name)  --> "Hello, 世界 "
  -- 上の行が機能しないようにするには、次の手順を実行してください：
  part = nil
  ```

  このメソッドで `Class.Instance` が破壊されたら、`Class.Instance.Parent` プロパティがロックされて再使用できなくなります。To **一時的に** 破壊するのではなく、オブジェクトを削除せずに、`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.Parent` から始まり、`Class.DataModel` に向かって作動します。一致する祖先が見つからない場合、`nil` を返します。

  次のコードスニペットは、名前が `Car` のオブジェクトの最初の祖先を見つけます。

  ```
  local car = object:FindFirstAncestor("Car")
  ```

  特定のクラスの祖先を見つけるこの機能のバリアントについては、`Class.Instance:FindFirstAncestorOfClass()` および `Class.Instance:FindFirstAncestorWhichIsA()` を参照してください。

Instance:FindFirstAncestor

name

返す 最初の祖先の の が指定された名前と同じである の 最初の祖先。

返すのは、`Class.Instance` の最初の祖先で、`Class.Object.ClassName` が指定された classNameと同等のもの。

  この機能は上向きで、つまりインスタンスの直接的な `Class.Instance.Parent` から始まり、`Class.DataModel` に向かって作動します。一致する祖先が見つからない場合、`nil` を返します。

  この機能の一般的な使用は、`Class.Model` に属する `Class.BasePart` を見つけることです。例えば:

  ```
  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
  ```

  ただし、次のコードサンプルは、 、 、または であるかどうかにかかわらず、最初の祖先を返します。

  ```
  local part = object:FindFirstAncestorWhichIsA("BasePart")
  ```

  参照してください `Class.Instance:FindFirstAncestor()` 。

Instance:FindFirstAncestorWhichIsA

返す 最初の祖先の `Class.Instance` について、`Class.Object:IsA()` が指定された className に対して true を返します。

以下は、ワークスペースで「ブリック」というオブジェクト名を検索します。見つかった場合、オブジェクト名を「フー」に変更します。

返す `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` は、子 `Class.Folder` インスタンスではなく、`Datatype.Color3` プロパティ値を参照しています。`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")  -- The child folder
  ```

  ##### 性能の注意事項

  `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:FindFirstChildWhichIsA()` とは異なり、この関数はクラスの相続を無視して、クラスの属性が `className` に一致するオブジェクトのみを返します。一致する子供が見つからない場合、この関数は `nil` を返します。

Instance:FindFirstChildOfClass

返すのは、 の最初の子供で、 が指定されたクラス名と同じの 。

`Class.Instance` に対する最初の子供を返し、`Class.Object:IsA()` が指定された className に対して true を返します。

  一致する子が見つからない場合、この関数は `nil` を返します。オプションの再帰的な引数が true の場合、この関数は `Class.Instance` の直接の子供だけでなく、すべての子孫を検索します。

  `Class.Instance:FindFirstChildOfClass()` とは異なり、この関数はクラスの継承を尊重する `Class.Object:IsA()` を使用します。たとえば:

  ```lua
  print(part:IsA("Part")) --> 真
  print(part:IsA("BasePart")) --> 真
  print(part:IsA("Instance")) --> true
  ```

  そのため、次のコードサンプルは、 、 、または であるかどうかにかかわらず、最初の子供を返します。

  ```
  local part = object:FindFirstChildWhichIsA("BasePart")
  ```

  名前で子を検索している開発者は、代わりに `Class.Instance:FindFirstChild()` を使用する必要があります。

Instance:FindFirstChildWhichIsA

`Class.Instance` に対する最初の子供を返し、`Class.Object:IsA()` が指定された className に対して true を返します。

指定された `Class.Instance.Name` で見つかった最初の子孫を返します。

  このメソッドは無効であり、使用できません。インスタンスの最初の子孫を見つけるには、代わりに `recursive` パラメータを `Class.Instance:FindFirstChild()` に使用することを検討してください。

Instance:FindFirstDescendant

指定された `Class.Instance.Name` で見つかった最初の子孫を返します。

If the `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)
  ```

  ##### 参照してください： See Also

  *   `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

文字列が属性の名前であり、変体が非ゼロ値である各属性のストリング → 変体のペアの辞書。

インスタンスの属性の辞書を返します。

The below would print the name of all objects currently in Workspace when ran.

すべてのインスタンスの直接の子供を含む配列 (数字でインデックス化されたテーブル) または、オブジェクトと同じ `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")

  -- 一般的な forループの例
  local children = Workspace:GetChildren()
  for i, child in children do
  	print(child.Name .. " is child number " .. i)
  end
  ```

  子供は、`Class.Instance.Parent|Parent` プロパティがオブジェクトに設定された順序でソートされます。

  また、`Class.Instance:GetDescendants()|GetDescendants` 機能も参照してください。

Instance:GetChildren

インスタンスの子供を含む配列。

インスタンスのすべての子を含む配列を返します。

Roblox 内で使用されているデバッグ ID のコード化された文字列を返します。注意:

  *   このアイテムは保護されています。`Class.Script` または `Class.LocalScript` で使用しようとすると、エラーが発生します。
  *   デバッグID は、デバッグプロセスで使用される IDです。デバッガーがアプリケーションが処理する前に、それぞれの指示を読むことができます。Roblox のすべてのオブジェクトはプロセスとして機能し、必要に応じてデバッグできる各実行指示（または「コード」）を実行します。
  *   これは、同じ名前を共有するオブジェクトを区別する必要があるプラグインにとって有用である可能性があります (例: 同じ名前を共有するオブジェクト)。

Instance:GetDebugId

scopeLength

Roblox 内で使用されているデバッグ ID のコード化された文字列を返します。

GetDescendants is often used to do something to all the descendants that are a
particular type of object. The code in this example uses GetDescendants and
`Class.Instance:IsA()` to find all of the parts in the workspace and turns
them green.

このオブジェクトメソッドは、そのオブジェクトのすべての子孫を含む配列を返します。`Class.Instance:GetChildren()` とは異なり、このメソッドはオブジェクトの即時の子供だけを返すのではなく、オブジェクトのすべての子供、それらの子供のすべての子供、などを見つけます。

Instance:GetDescendants

インスタンスの子孫を含む配列。

インスタンスのすべての子孫を含む配列を返します。

This code sample demonstrates the behavior of `Class.Instance:GetFullName()`.
It shows how the function behaves when called on an object not in the
`DataModel` hierarchy, and it also shows how the return value does not escape
special characters.

This code sample re-implements the `Class.Instance:GetFullName()` function in
Lua.

インスタンスの祖先を説明する文字列を返します。文字列は、オブジェクトとその祖先の `Class.Instance.Name|Name` の連結で、期間で区切られています。The `Class.DataModel` ( `game` ) は考慮されません。たとえば、`Class.Part` 中の `Class.Workspace` は、`Class.Workspace.Part` を返す可能性があります。

  When called on an `Class.Instance` それは `Class.DataModel` の子孫ではない場合、この関数は、`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 (modified value)
  ```

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("Style property changed!")
  end

  meterBar:GetStyledPropertyChangedSignal("AnchorPoint"):Connect(stylePropertyChanged)
  ```

Instance:GetStyledPropertyChangedSignal

property

変更を検出するスタイルプロパティの名前。

指定されたスタイルプロパティが変更されたときに発動するイベント。

このメソッドは、指定されたインスタンスに適用されたタグの配列を、文字列として返します。タグを追加できるのは、[プロパティ](/studio/properties) ウィンドウで Studio で、またはランタイムで `Class.Instance:AddTag()|AddTag()` です。

  このメソッドは、インスタンスで一度に複数のタグを使用したいときに便利です。ただし、単一のタグの存在をチェックするためにこのメソッドを使用するのは非効率であり、代わりに `Class.Instance:HasTag()|HasTag()` を使用して特定のタグをチェックします。

Instance:GetTags

インスタンスに適用されたすべてのタグの配列を取得します。

このメソッドは、提供されたタグがオブジェクトに追加された場合に `true` を返します。タグを追加できるのは、[プロパティ](/studio/properties) ウィンドウで Studio に、またはランタイムで `Class.Instance:AddTag()|AddTag()` です。

Instance:HasTag

インスタンスに指定されたタグがあるかどうかをチェックします。

Demonstrates determining if one instance is the ancestor of another using `Class.Instance:IsAncestorOf()`

Workspace and SpawnLocation are ancestors of the SpawnLocation's decal.
Workspace is an ancestor of SpawnLocation.

SpawnLocation and its decal are descendants of Workspace, not ancenstors.
Decal is a descendant to SpawnLocation, not an ancestor.

`Class.Instance` が指定された後継者の祖先である場合、真を返します。

  はオブジェクトの祖先と見なされ、オブジェクトの またはその親の が に設定されている場合、その親の祖先と見なされます。

  参照してください, `Class.Instance:IsDescendantOf()` .

Instance:IsAncestorOf

`Class.Instance` が指定された後継者の祖先である場合は、真です。

`Class.Instance` が指定された後継者の祖先である場合、真を返します。

`true` が指定された祖先の子孫である場合、`Class.Instance` を返します。

  注意: `IsDescendantOf()` は、オブジェクトが削除されたかどうかをチェックするために `nil` のパラメータを使用できません。

  参照してください `Class.Instance:IsAncestorOf()` 。

Instance:IsDescendantOf

ancestor

`Class.Instance` が指定された祖先の子孫である場合は、真です。

`true` が指定された祖先の子孫である場合、`Class.Instance` を返します。

指定されたプロパティに保存された値がコードでインスタンス化されたデフォルトと同等の場合、`true` を返します。たとえば、出力の プロパティの が を指し示している場合、ラベルに を呼び出すと、ラベルが作成されるときに がデフォルト値になるため、スタジオの挿入ワークフローを介して挿入されるのではなく、ラベルを作成するときに が返されます。

  このメソッドが `true` を返す場合、スタイリングは **しません** プロパティを明示的に変更することが優先されるため、スタイリングに影響しません。

Instance:IsPropertyModified

プロパティが変更されているかどうかを示すブール。

指定されたプロパティに保存された値がコードでインスタンス化されたデフォルトと同等の場合、`true` を返します。

The following code demonstrates how a part can be re-added to the DataModel
after being removed:

この機能は、オブジェクトの `Class.Instance.Parent` を `nil` に設定し、すべての子孫に同じことを行います。

  オブジェクトが削除される前に参照されると、後でオブジェクトを回収できます。

Instance:Remove

オブジェクトの `Parent` を `nil` に設定し、すべての子孫に同じことを行います。

このメソッドは、インスタンスからタグを削除します。オブジェクトにタグがない場合、エラーをスローしません。タグを正常に削除すると、指定されたタグで `Class.CollectionService:GetInstanceRemovedSignal()` によって作成されたシグナルが発射されます。

  インスタンスをタグ付けするときは、タグの機能を提供するために、例えばイベント接続またはテーブルが使用されるのが一般的であることに注意してください。メモリ漏れを防ぐには、タグがもう必要ないときにこれらをクリーンアップする (接続を切断し、`nil` に設定など) が良い考えです。

Instance:RemoveTag

インスタンスからタグを削除します。

プロパティをデフォルト値にリセットします。たとえば、`ResetPropertyToDefault("Rotation")` を `Class.TextLabel` に呼び出すことは、その `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** で始まることは許可されていません。

  アトリビュートを未対応のタイプに設定しようとすると、エラーが発生します。

  ##### 参照してください： See Also

  *   `Class.Instance:GetAttribute()` これは、指定された属性名に割り当てられた値を返す。
  *   `Class.Instance:GetAttributes()` は、インスタンスの属性ごとにキー-バリューペアの辞書を返す。

Instance:SetAttribute

value

指定された属性を設定する値。

指定された名前の属性を指定された値に設定します。

The following code waits for an instance named "Part" to be added to
Workspace.

返す `Class.Instance` の子に指定された名前を付けます。子が存在しない場合、それが行われるまで現在のスレッドが返されます。`timeOut` パラメータが指定されると、このメソッドは指定された秒数後に期限切れになり、`nil` を返します。

  ##### 主な使用法

  `Class.Instance:WaitForChild()|WaitForChild()` は、クライアントによって実行されるコードを `Class.LocalScript` で作業するときに非常に重要です。Roblox エンジンは、オブジェクトがサーバーからクライアントにレプリケートされる時間または順序を保証しません。さらに、エクスペリエンスに `Class.Workspace.StreamingEnabled` が真に設定されている場合、プレイヤーのキャラクターから遠く離れた `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()` がインスタンスの祖の 1 つに呼び出されるときに含めるべきかどうかを決定します。インスタンスに直接 を呼び出すと、そのインスタンスが でない場合、 が返されます。

  スタジオで 複製 または コピー / 貼り付け オプションを使用してオブジェクトをコピーすると、自分の プロパティを無視し、コピーに を設定します。

  ```
  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()` のように、1つのオブジェクトだけを返すが、必ずしも望んでいるオブジェクトではない。特定のオブジェクトにコードを介してアクセスする必要がある場合、ユニークな名前を付与するか、同じ名前を共有しないことを保証することをお勧めします。

  も参照してください `Class.Instance:GetFullName()` オブジェクトの階層を含む全名を取得するには。

Instance.Name

非唯一の識別子 `Class.Instance` 。

The `Parent` プロパティは、`Class.Instance` の階層上の親を決定します。次の用語は、このプロパティが設定される方法について話すときによく使用されます：

  *   オブジェクトは、 **子供** であるか、 **親** になり、その `Parent` がそのオブジェクトに設定されると、他のオブジェクトになります。

  *   **子孫** は、`Class.Instance` の子孫であり、子孫の子孫も含まれます。

  *   インスタンスが子孫であるすべてのオブジェクトは、 祖先 です。

  それは `Parent` プロパティから、多くの他の API メンバーが名前を取得している、例えば `Class.Instance:GetChildren()|GetChildren()` や `Class.Instance:FindFirstChild()|FindFirstChild()` など。このプロパティは、オブジェクトがエクスペリエンスに存在するか、削除する必要があるかを管理するのにも使用されます。オブジェクトの親が `Class.DataModel` にある限り、変数に保存されたり、別のオブジェクトのプロパティに参照されたりして、オブジェクトは経験に残ります;そうでない場合、オブジェクトは自動的に削除されます。

  呼び出し `Class.Instance:Destroy()|Destroy()` は、`Parent` の `Class.Instance` とすべての子孫を `nil` に設定し、また **ロック** プロパティを `Parent` します。破壊されたオブジェクトの `Parent` を設定すると、エラーが発生します。

  新しく作成されたオブジェクトは、`Datatype.Instance.new()` を使用して作成され、通常、親が設定されるまで表示されたり機能したりしません。

  ##### オブジェクトレプリケーション

  サーバーによって作成されたオブジェクトは、レプリケートされる対象に親属するまで、クライアントにレプリケートされません。オブジェクトを作成し、多くのプロパティを設定するときは、`Parent` プロパティを設定することをお勧めします。When creating an object and setting many properties, it's recommended to set the  最後 property **last** .これにより、複数のプロパティ変更をレプリケートするのではなく、オブジェクトが 1 回レプリケートされます。

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

  -- 新しいインスタンスの親を最後に設定する (推奨)
  local part = Instance.new("Part")
  part.Position = Vector3.new(0, 10, 0)
  part.Parent = Workspace
  ```

  しかし、親がまだ設定されていない `Class.Model` のパーツに親を付ける場合、そのモデルに各パーツを親に付けることは可能です。モデルは再複製されないので、モデルに親を付けることは受け入れられます。

Instance.Parent

`Class.Instance` の階層親を決定します。

このプロパティは、`Class.CoreGui` サービスのオブジェクトを無許可の方法でユーザーに変更されるのを防ぐために使用されていました。廃止されており、何もしません。

Instance.RobloxLocked

`Class.CoreGui` オブジェクトを保護するのに使用されていた廃止されたプロパティ。

インスタンスを **サンドボックス化コンテナ** に変換し、特定のコンテナ内のスクリプトが実行できるアクションを制限する実験的な機能。詳細については、[スクリプト機能](/scripting/capabilities) を参照してください。

Instance.Sandboxed

インスタンスをサンドボックス化されたコンテナに変えます。

インスタンスのユニークな識別子で、必ずしもユニークではない `Class.Instance.Name` とは異なります。

Instance.UniqueId

インスタンスのユニークな識別子。

`Instance` は、`Class.DataModel` ツリーの一部である Roblox クラス階層のすべてのクラスのベースクラスです。

Folder

概要

プロパティ

方法

イベント

プロパティ

方法

イベント