MicroProfilerService

MicroProfilerService.ContextLabel

`Instance` はRobloxクラス階層のすべてのクラスの基本クラスであり、`Class.DataModel` ツリーの一部であることができます。

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

インスタンスの系譜に対する変更を検出する方法を示します。
`Class.Instance.AncestryChanged` イベントに接続することで実現します。

ChangingPart の親は時間とともに異なる値に設定されます。パーツの親はパーツの先祖であるため、
`Class.Instance.AncestryChanged` イベントは変更されるたびに発火します。


このインスタンスが再親和されたときや、その先祖のいずれかが再親和されたときに発火します。

このイベントを使用して、スタジオ内のインスタンスの削除を追跡できます。例えば、Explorer での手動削除やプラグインを通じての削除です。`Class.Instance:Destroy()` を使用してインスタンスが破壊されたときに検出する必要がある場合は、代わりに `Class.Instance.Destroying` イベントを使用してください。

Instance.AncestryChanged

child

`Class.Instance.Parent|Parent` プロパティが変更されたインスタンス。これがこのインスタンスか、より遠い先祖である可能性がありますが、必ずしもハンドラーに接続されているインスタンスとは限りません。

parent

`child` パラメータの新しい親。

このオブジェクトまたはその先祖の `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` の属性が変更されるたびに発火します。

このスニペットは、オブジェクトがWorkspaceに追加されると、その名前を出力します:

この `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` から子が削除された後に発火します。

次の例では、Workspaceに追加されたオブジェクトの名前を印刷します:

このイベントは、子孫がこの `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` の子孫が削除される直前に発火します。

このサンプルは、Immediate シグナル動作を使用する際に、
インスタンスが破棄されるまで、接続された関数が yield するまでその位置に留まることを示しています。


このサンプルは、Deferredシグナルの動作を使用する際に、インスタンスがシグナルが発火する前に破棄される方法を示しています。


接続された関数がまだ使用している間、`Class.Instance` は決してメモリから削除されることはありません。ただし、関数が途中でyieldする場合、`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` イベントに接続すると、スクリプトがコールバックの呼び出し前に破壊されるため問題が発生します（つまり、コールバックは実行されません）。

スタジオでの `Class.Instance` の削除は、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` に設定されたときも含まれます。

このメソッドはインスタンスにタグを適用し、タグがすでに適用されている場合には効果がありません。タグを正常に追加すると、`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.Model` からのすべての `Class.BasePart|BaseParts` を破壊します：

```
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` でないインスタンスを無視します。

Instance:clone

このサンプルは、`Class.Instance:Destroy()` 関数を使用してパーツを削除する方法を示します。

この関数は、もはや必要ないオブジェクトを処理する正しい方法です。


`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.Name` を持つ `Class.Instance` の最初の祖先を返します。

このメソッドは上方向に機能します、つまり、インスタンスの直接の `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` の最初の祖先を返します。

指定された className に等しい `Class.Object.ClassName` を持つ `Class.Instance` への最初の祖先を返します。

このメソッドは上方向に機能します、つまり、インスタンスの直接の `Class.Instance.Parent` から始まり、`Class.DataModel` に向かいます。一致する祖先が見つからない場合は、`nil` を返します。

このメソッドの一般的な用途は、`Class.BasePart` が属する `Class.Model` を見つけることです。たとえば：

```
local model = part:FindFirstAncestorOfClass("Model")
```
このメソッドは、`Class.Instance:FindFirstAncestor()` のバリアントであり、`Class.Object.ClassName` プロパティを確認します。
`Class.Instance:FindFirstAncestorWhichIsA()` も存在し、代わりに `Class.Object:IsA()` を用いてクラスの継承を尊重します。

Instance:FindFirstAncestorOfClass

className

探す `Class.Object.ClassName` です。

指定された className に等しい `Class.Object.ClassName` を持つ `Class.Instance` への最初の祖先を返します。

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

このメソッドは上方向に機能します、つまり、インスタンスの直接の `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

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

以下は、Workspace内でオブジェクト名「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` のプロパティと同じであることがあります。ドットオペレーターを使用すると、名前が同じ場合はプロパティが子供よりも優先されます。

次の例では、`Class.Part` に `Color` という `Class.Folder` が追加され、同時に `Class.Part.Color` プロパティも持っています。注意が必要なのは、`part.Color` は子供の `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

検索する `Class.Instance.Name` です。

recursive

検索を再帰的に行うかどうか。

指定された名前を持つ最初の `Class.Instance` の子を返します。

Instance:findFirstChild

指定された `className` に等しい `Class.Object.ClassName|ClassName` を持つ `Class.Instance` の最初の子を返します。`Class.Instance:FindFirstChildWhichIsA()` とは異なり、このメソッドは一致するクラスのみを返し、クラスの継承を無視します。一致する子が見つからない場合、このメソッドは `nil` を返します。

Instance:FindFirstChildOfClass

検索する `Class.Object.ClassName` です。

指定されたクラス名に等しい `Class.Object.ClassName|ClassName` を持つ `Class.Instance` の最初の子を返します。

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

一致する子が見つからない場合、このメソッドは `nil` を返します。オプショナルの再帰的引数が `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

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

指定された `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

`Instance` に関連付けられている `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` イベントに非常に似た動作をしますが、特定の指定された属性が変更されたときだけ発生します。

一般的に、このメソッドを使用して特定の属性名を確認する関数に接続するよりも、これを使用することが良いアイデアです。同じオブジェクトに対して同じ属性名でこのメソッドを呼び出すと、同じイベントが返されます。

次のコード例では、部分の `InitialPosition` 属性が変更されると、`attributeChanged()` 関数が発生する信号を返します：

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

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local function attributeChanged()
	print("属性が変更されました")
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` の値を持つ各属性のキー-バリューペアの辞書です。

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

下記は、実行時にWorkspace内のすべてのオブジェクトの名前を印刷します。

すべてのインスタンスの直接の子供を含む配列（数値インデックスのテーブル）を返します。オブジェクトの `Class.Instance.Parent|Parent` が等しいすべての `Class.Instance` です。配列は数値または一般的な `for` ループを使用して繰り返すことができます：

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

-- 数値ループの例
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " は子供の番号 " .. i .. " です")
end
```

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

-- 一般的なループの例
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " は子供の番号 " .. 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

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

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

このコードサンプルは、`Class.Instance:GetFullName()` の動作を示します。
`DataModel` 階層にないオブジェクトで呼び出したときの関数の動作を示し、
戻り値が特殊文字をエスケープしないことも示します。

このコードサンプルは、`Class.Instance:GetFullName()` 関数を Lua で再実装します。

インスタンスの系譜を説明する文字列を返します。この文字列は、オブジェクトの `Class.Instance.Name|Name` とその祖先がドットで区切られる連結です。`Class.DataModel` （`game`）は考慮されません。たとえば、`Class.Workspace` 内の `Class.Part` は `Class.Workspace.Part` を返す可能性があります。

`Class.DataModel` の子孫でない `Class.Instance` に呼び出された場合、このメソッドは `Class.Instance.Parent|Parent` を持たない最上層の祖先までのすべての祖先を考慮します。

このメソッドはロギングやデバッグに役立ちます。返された文字列を有用な操作のために解析しようとしないでください；このメソッドはオブジェクトの名前でドット（または他の記号）をエスケープしません。言い換えれば、出力はしばしば有効なLuau識別子のように見えますが、保証されているわけではありません。

Instance:GetFullName

フルネームの `Class.Instance` です。

インスタンスの系譜を説明する文字列を返します。

このメソッドは、指定されたプロパティのスタイルまたは明示的に変更された値を返すか、スタイル/変更されていない場合はデフォルトのプロパティ値を返します。これは、指定されたプロパティの値を直接アクセスすることと少し異なります、例えば `[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 (変更された値)
```

Instance:GetStyled

クエリするプロパティの名前。

selector

インスタンス上でターゲットにしている擬似インスタンスのオプションのセレクター。

指定されたプロパティのスタイルまたは明示的に変更された値、またはスタイル/変更されていない場合はデフォルトのプロパティ値。

指定されたプロパティのスタイルまたは明示的に変更された値を返すか、スタイル/変更されていない場合はデフォルトのプロパティ値を返します。

このメソッドは、`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("スタイルプロパティが変更されました！")
end

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

Instance:GetStyledPropertyChangedSignal

property

変更の監視を行うスタイルプロパティの名前。

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

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

このメソッドは、インスタンス上の複数のタグで何かをしたい場合に便利です。ただし、特定のタグの存在を確認するためにこのメソッドを使用することは非効率的であり、代わりに特定のタグを確認するには `Class.Instance:HasTag()|HasTag()` を使用してください。

Instance:GetTags

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

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

Instance:HasTag

インスタンスが指定されたタグを持っているかどうかを確認します。

あるインスタンスが別のインスタンスの祖先であるかどうかを判断する方法を示します。
`Class.Instance:IsAncestorOf()`

WorkspaceとSpawnLocationは、SpawnLocationのデカールの祖先です。
WorkspaceはSpawnLocationの祖先です。

SpawnLocationとそのデカールはWorkspaceの子孫であり、祖先ではありません。
DecalはSpawnLocationの子孫であり、祖先ではありません。


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

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

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

Instance:IsAncestorOf

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

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

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

`IsDescendantOf()` に `nil` を引数として使用することはできず、オブジェクトが削除されたかどうかを確認するために使用することはできません。

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

Instance:IsDescendantOf

ancestor

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

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

Instance:isDescendantOf

このメソッドは、特定のプロパティがコードでインスタンス化されたデフォルトから変更されたかどうかを示します。`Datatype.Instance.new()` を介して新しく作成されたインスタンスで呼び出された場合、このメソッドは `false` を返します。`Explorer` ウィンドウで挿入されたスタジオのワークフローで新しく作成されたオブジェクトで呼び出された場合、結果が異なる場合があります。

たとえば、`[Explorer](/studio/explorer)` を介して挿入された `Class.TextLabel` の `BackgroundColor3|BackgroundColor3` プロパティをクエリすると、`true` が返されますが、`Datatype.Instance.new()` を介して作成された `Class.TextLabel` の同じプロパティをクエリすると、他に変更が行われていない場合は `false` が返されます。

このメソッドは、サービスやユーザー作成可能なインスタンスに対してのみ有用な結果を返します。`Class.PackageLink` のようなインスタンスのシステム生成プロパティの戻り値は未定義の動作です。

このメソッドが `true` を返す場合、スタイリングはプロパティに影響しないことを注意してください。なぜなら、プロパティを明示的に変更すると、スタイリングよりも優先されるためです。プロパティをコーディングでインスタンス化されたデフォルトにリセットし、そのプロパティでスタイリングを許可するには、`Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()` を使用してください。

Instance:IsPropertyModified

そのプロパティがコーディングでインスタンス化されたデフォルトから変更されているかどうかを示すブール値です。

指定されたプロパティに格納された値が、コーディングによってインスタンス化されたデフォルトと等しくない場合は `true` を返します。

このオブジェクトメソッドは、指定された `selector` 文字列に一致するオブジェクトのすべての子孫を含む配列を返します。`selector` には、クラス名、インスタンス名、階層関係、インスタンスプロパティや属性の特定の値に一致させるための複数のセレクタとコンビネーターを含めることができます。`selector` の文法は、`Class.StyleRule` で使用されるものに似ていますが、サポートされている文法の部分に関していくつかの違いがあります。

#### セレクタ

- `ClassName` — 指定されたクラスのインスタンスと `Class.Object:IsA()` 関係に一致します。
- `.Tag` — `Class.CollectionService` タグが付けられたインスタンスに一致します。
- `#Name` — 特定の `Class.Instance.Name` のインスタンスに一致します。
- `[property = value]` — 指定されたプロパティを持ち、そのプロパティの指定された値があるインスタンスに一致します。ブール値、数値、文字列がサポートされています。文字、数字、`_`、および `-` は、値を引用符で囲まずに使用できます。
- `[$attribute]` — 指定された [attribute](/studio/properties#instance-attributes) が設定されたインスタンスに一致します。
- `[$attribute = value]` — 指定された属性を持ち、その属性が指定された値に一致するインスタンスに一致します。プロパティセレクタと同じ制限が適用されます。属性の存在しないことを確認したい場合は、`nil` としてクエリせずに、` :not` 擬似クラスを使用して `:not([$attribute])` のようにします。

セレクタは組み合わせて使用することもできます。たとえば、
`Model.Apple[$Variety = Fuji][$Flavor = 4]` は、`Apple` としてタグ付けされた `Class.Model` であり、 `Variety` 属性が `Fuji` に等しく、 `Flavor` 属性が `4` に等しいインスタンスに一致します。

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

-- MeshPart のすべての子孫を取得
print(Workspace:QueryDescendants("MeshPart"))

-- "Fruit" としてタグ付けされたすべての子孫を取得
print(Workspace:QueryDescendants(".Fruit"))

-- 名前が "RedTree" のすべての子孫を取得
print(Workspace:QueryDescendants("#RedTree"))

-- CanCollide プロパティが false に設定されているすべての子孫を取得
print(Workspace:QueryDescendants("[CanCollide = false]"))

-- "FuelCapacity" 属性が設定されたすべての子孫を取得
print(Workspace:QueryDescendants("[$FuelCapacity]"))
-- "FuelCapacity" 属性が 75 に設定されたすべての子孫を取得
print(Workspace:QueryDescendants("[$FuelCapacity = 75]"))
```

#### コンビネーター

コンビネーターを使用すると、基本のセレクタを組み合わせて、より深い階層関係を一致させることができます。

- `>` — 前のフィルタに一致するインスタンスの **直下の子** に一致します。

- `>>` — 前のフィルタに一致するインスタンスの **子孫** に一致します。これは最初のフィルタのデフォルトであり、`SpotLight.Red` は `>> SpotLight.Red` と同じです。

- `,` — 子孫クエリのための複数の独立したセレクタのリストを指定します。フィルタに一致する要素のみが返された配列に配置され、クエリリストの非一致のために `nil` は含まれません。

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

-- "SwordPart" としてタグ付けされた任意の Model の直接の子を取得
print(Workspace:QueryDescendants("Model > .SwordPart"))

-- Part であり、"Apple" としてタグ付けされた直接の子を取得
print(Workspace:QueryDescendants("> Part.Apple"))

-- 属性 "OnFire" が true に設定されている任意の Model の子孫を取得
print(Workspace:QueryDescendants("Model >> [$OnFire = true]"))

-- MeshPart の子孫で "SwordPart" としてタグ付けされているか、属性 "OnFire" が true に設定されているものを取得
print(Workspace:QueryDescendants("MeshPart.SwordPart, MeshPart[$OnFire = true]"))
```

#### 擬似クラスセレクタ

- `:not(complex-selector-list)` — 内部のいずれかのセレクタに **一致しない** インスタンスを選択できるようにし、実質的にセレクタの否定を実行します。内部の式は複雑なセレクタのリストであるため、複数の条件に基づいてフィルタリングできます。

- `:has(relative-selector-list)` — 含まれるインスタンスに基づいてインスタンスを選択できるようにします。セレクタリストは、各インスタンスに対して相対的に評価されます。

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

-- クラス SpotLight ではないすべての子孫を取得
print(Workspace:QueryDescendants(":not(SpotLight)"))
-- クラス SpotLight または PointLight ではないすべての子孫を取得
print(Workspace:QueryDescendants(":not(SpotLight, PointLight)"))
-- 属性 "OnFire" を持っていないすべての子孫を取得
print(Workspace:QueryDescendants(":not([$OnFire])"))
-- "SwordPart" としてタグ付けされた Model の子を除くすべての子孫を取得
print(Workspace:QueryDescendants(":not(Model > .SwordPart)"))

-- 自身の子孫として Tool インスタンスを含む子孫を取得
print(Workspace:QueryDescendants(":has(Tool)"))
-- 直接の子として "SwordPart" としてタグ付けされた MeshPart の子孫を取得
print(Workspace:QueryDescendants("MeshPart:has(> .SwordPart)"))

-- SurfaceAppearance または Texture クラスの直接の子ではない MeshPart の子孫を取得
print(Workspace:QueryDescendants("MeshPart:has(> :not(SurfaceAppearance, Texture))"))
```


Instance:QueryDescendants

要素をフィルターするために使用されるセレクター文字列です。

選択子に一致するインスタンスの配列（一致するものがない場合は空）。

指定された `selector` 文字列に一致するインスタンスのすべての子孫を含む配列を返します。


次のコードは、削除された後にパートをDataModelに再追加する方法を示しています:

このメソッドはオブジェクトの `Class.Instance.Parent` を `nil` に設定し、その子孫全体にも同様の処理を行います。

オブジェクトが削除される前に参照されている場合、後でオブジェクトを取得することが可能です。

Instance:Remove

オブジェクトの `Parent` を `nil` に設定し、その子孫全体にも同様の処理を行います。

Instance:remove

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

インスタンスにタグを付ける際には、タグの機能を提供するためにリソースが使用されることが一般的です。例えば、イベント接続やテーブルなどです。メモリリークを防ぐために、タグが不要になった時にこれらをクリーンアップする（切断、`nil`に設定など）ことをお勧めします。

Instance:RemoveTag

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

プロパティをデフォルト値にリセットします。例えば、`Class.TextLabel` の `ResetPropertyToDefault("Rotation")` を呼び出すことは、その `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文字以下でなければなりません。
- **RBX** で始まる名前は許可されていません（Roblox に予約されています）。

サポートされていないタイプの属性を設定しようとした場合、エラーが発生します。

#### 参照

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

Instance:SetAttribute

value

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

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

以下のコードは、"Part"という名前のインスタンスが
Workspaceに追加されるのを待ちます。

`Class.Instance` の指定された名前の子を返します。子が存在しない場合、存在するまで現在のスレッドをyieldします。`timeOut` パラメータが指定されている場合、このメソッドは指定された秒数の後にタイムアウトし、`nil` を返します。

#### 主な使用法

`Class.Instance:WaitForChild()|WaitForChild()` は、`Class.LocalScript` のクライアントによるコード作成時に非常に重要です。Roblox エンジンは、オブジェクトがサーバーからクライアントに複製される時間や順序を保証しません。さらに、体験が `Class.Workspace.StreamingEnabled` を true に設定している場合、プレイヤーのキャラクターから遠く離れた `Class.BasePart|BaseParts` はクライアントにストリームされない可能性があり、スクリプトが、まだクライアント上に存在しないオブジェクトのインデックスを取得する際に破損する可能性があります。

#### 注

- このメソッドは、呼び出し時に指定された名前の子が存在する場合、yield しません。
- `Class.Instance:FindFirstChild()` は、存在すると想定されるオブジェクトに対して `Class.Instance:WaitForChild()|WaitForChild()` のより効率的な代替手段です。
- このメソッドへの呼び出しが5秒を超え、返されない場合、`timeOut` パラメータが指定されていない場合、無限にスレッドがyieldする可能性があるという警告が出力に印刷されます。

Instance:WaitForChild

childName

timeOut

オプションのタイムアウトパラメータ。

`Class.Instance` の指定された名前の子を返します。子が存在しない場合、存在するまで現在のスレッドをyieldします。

Instance

このプロパティは、経験が公開または保存されるとき、または `Class.Instance:Clone()` がそのインスタンスの祖先のいずれかに対して呼び出されたときに、インスタンスを含めるべきかどうかを決定します。
インスタンスに直接 `Class.Instance:Clone()` を呼び出すと、そのインスタンスが **ない** `Class.Instance.Archivable|Archivable` の場合は `nil` を返します。

Studioで**Duplicate**または**Copy**/**Paste**オプションを使用してオブジェクトをコピーすると、自身の `Class.Instance.Archivable|Archivable` プロパティを無視し、コピーのために `Class.Instance.Archivable|Archivable` を `true` に設定します。

```
local part = Instance.new("Part")
print(part:Clone())  --> Part
part.Archivable = false
print(part:Clone())  --> nil
```

Instance.Archivable

指定の `Class.Instance` とその子孫が `Class.Instance:Clone()` を使ってクローンできるかどうかを決定し、保存/公開できるかを判定します。

Instance.archivable

このインスタンス内でスクリプトに使用できる機能のセットです。機能が有効になるためには、`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()` と同様ですが、常に望ましいオブジェクトが得られるわけではありません。
特定のオブジェクトにコードを介してアクセスする必要がある場合、ユニークな名前を付けるか、その兄弟が同じ名前を共有しないことを保証することが推奨されます。

オブジェクトの階層を含むフルネームを取得するには、`Class.Instance:GetFullName()` を参照してください。

Instance.Name

`Class.Instance` の非ユニーク識別子です。

`Instance` はRobloxクラス階層のすべてのクラスの基本クラスであり、`Class.DataModel` ツリーの一部であることができます。

/reference/engine/classes/MicroProfilerService.yaml