An `InputContext` は関連する `Class.InputAction|InputActions` を保持し、他のコンテキストやアクションとどのように相互作用するかを定義するアクションのコレクションです。ネストされた `InputContext` インスタンスは影響を持たず、順序/優先度は `Class.InputContext.Enabled|Enabled`、`Class.InputContext.Priority|Priority`、および `Class.InputContext.Sink|Sink` を通じて管理されます。


InputContext

この `InputContext` が有効かどうかを決定します。`false` の場合、コンテキストのすべての子孫アクションは、`Enabled` が `true` から `false` に切り替えられる場合を除き、信号を受け取ることはありません。この場合、キーが押されたり双方向入力がゼロでない場合、最終的な「終了」信号がトリガーされます。


InputContext.Enabled

この `InputContext` が有効かどうかを決定します。


コンテキストが実行される優先度レベルです（優先度の高い `InputContext` インスタンスは低いものの前に実行されます）。


InputContext.Priority

コンテキストが実行される優先度レベルです。


`Sink` が `true` に設定されている場合、低い `Class.InputContext.Priority|Priority` のコンテキスト内の接続された `Class.InputAction` バインディングの入力は処理されません。同じ優先度のコンテキストは入力を受け取ります。

例えば、複数のコンテキストが `Enum.KeyCode.E` へのバインディングを持ち、優先度の高いコンテキストが `Sink` を `true` に設定している場合、低い優先度のコンテキストは `Enum.KeyCode.E` の入力信号を受け取らず、そのためのイベントがトリガーされることはありません。


InputContext.Sink

低い優先度の入力バインディングが処理されるかどうかを決定します。


関連するアクションを保持し、それらが他のコンテキスト/アクションとどのように相互作用するかを定義するアクションのコレクションです。


`Instance` は、`Class.DataModel` ツリーの一部となることができるロブロックスクラス階層内のすべてのクラスの基底クラスです。

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

インスタンスの系譜の変化を検出する方法を示しています。`Class.Instance.AncestryChanged`イベントに接続します。

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

オブジェクトまたはその先祖の`Class.Instance.Parent`プロパティが変更されたときに発火します。

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

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

Instance.AncestryChanged

child

変更された`Class.Instance.Parent`を持つ`Class.Instance`。

parent

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

オブジェクトまたはその先祖の`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

インスタンスで属性が変更されるたびに発火します。

このスニペットは、オブジェクトが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`にオブジェクトが親子関係を持つようになった後に発火します。

このスニペットは、オブジェクトがワークスペースから削除されるときにその名前を表示します:

子がこの `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` です。

この`Class.Instance`の子孫が削除される直前に発火します。

このサンプルは、即時シグナルの動作を使用する際に、インスタンスが破壊されるときに接続された関数が待機するまでその場所に留まることを示しています。

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

接続された関数がまだそれを使用している間、`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](/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("スタイルプロパティが変更されました")
end

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

Instance.StyledPropertiesChanged

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

Instance.childAdded

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

##### 警告

- クライアントサイドで追加されたインスタンスのタグは、サーバーが後でそのインスタンスにタグを追加または削除する場合にドロップされます。サーバーはすべてのタグを一緒に複製し、以前のタグを上書きするためです。

- インスタンスにタグを付けると、タグの機能を持たせるためにリソース（イベント接続やテーブルなど）を使用することが一般的です。メモリリークを防ぐために、タグがもはや必要とされなくなった場合は、それらをクリーンアップする（切断、`nil` に設定など）ことをお勧めします。`Class.Instance:RemoveTag()` を呼び出すとき、または `Class.Instance:Destroy()` を呼び出すとき、または `Class.CollectionService:GetInstanceRemovedSignal()` が返すシグナルに接続された関数内でこれを行います。

Instance:AddTag

インスタンスにタグを適用します。

このメソッドは、インスタンスのすべての子要素とその子孫を破棄します。

```
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())  --> 子要素: 3

part:ClearAllChildren()

print("Children:", #part:GetChildren())  --> 子要素: 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: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()` を呼び出します。

与えられた名前が等しい最初の先祖を返します。

このメソッドは上向きに動作します。すなわち、インスタンスの直上の `Class.Instance.Parent` から始まり、
`Class.DataModel` へと進みます。見つからない場合は `nil` を返します。

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

```
local car = object:FindFirstAncestor("Car")
```
特定のクラスの先祖を見つけるこのメソッドのバリアントについては、`Class.Instance:FindFirstAncestorOfClass()` と
`Class.Instance:FindFirstAncestorWhichIsA()` を参照してください。

Instance:FindFirstAncestor

name

探している `Class.Instance.Name` です。

見つかった `Class.Instance` です。

`Class.Instance` の最初の先祖を返します。

与えられた `className` と等しい最初の先祖を返します。

このメソッドは上向きに動作します。すなわち、インスタンスの直上の `Class.Instance.Parent` から始まり、
`Class.DataModel` へと進みます。見つからない場合は `nil` を返します。

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

```
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` です。

与えられた `className` に対して `Class.Object:IsA()` が `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
```
したがって、次のコードサンプルは、最初の `Class.BasePart` 先祖を返します。
`Class.WedgePart`、`Class.MeshPart` または `Class.Part` であるかどうかにかかわらず。

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

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

Instance:FindFirstAncestorWhichIsA

以下は、Workspace内でオブジェクト名「Brick」を探します。見つかった場合、それ
はオブジェクトの名前を「Foo」に変更します。

与えられた名前を持つ最初の子要素を返し、そのような子要素が存在しない場合は `nil` を返します。オプションで `recursive` 引数が `true` の場合、このメソッドは `Class.Instance` の直近の子要素だけでなく、すべての子孫を検索します。

##### オブジェクトの存在を確認する

`FindFirstChild()` は、オブジェクトが存在することを確認する必要がある場合に必要です。
子の名前をドット演算子でインデックスしようとすると、子が存在しない場合はエラーが発生します。

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

-- 以下の行は、パートがワークスペースに存在しない場合、エラーが発生します。
Workspace.Part.Transparency = 0.5
```
より良いアプローチは、最初に `Part` を確認するために `FindFirstChild()` を使用し、その後、必要なコードを実行する `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` のプロパティと同じ場合があります。ドット演算子を使用する際、同じ名前のプロパティは子要素よりも優先されます。

次の例では、`Color` と呼ばれる `Class.Folder` が `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")  -- 子フォルダー
```

##### パフォーマンスの注意点

`Class.Instance:FindFirstChild()|FindFirstChild()` は、ドット演算子を使用するよりも約20%長く、オブジェクトを参照に保存するよりもほぼ8倍長くかかります。したがって、パフォーマンスに依存するコード（例えば、タイトなループや `Class.RunService.Heartbeat` および `Class.RunService.PreRender` に接続された関数内）では呼び出すことは避けるべきです。むしろ、結果を変数に保存するか、オブジェクトが存在すると仮定して `Class.Instance:FindFirstChild()` を使用することを検討してください。

Instance:FindFirstChild

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

recursive

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

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

与えられた `className` と等しい最初の子要素を返します。
`Class.Instance:FindFirstChildWhichIsA()` とは異なり、このメソッドは、クラスの継承を無視して `className` に一致するオブジェクトのみを返します。見つからない場合、このメソッドは `nil` を返します。

Instance:FindFirstChildOfClass

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

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

与えられた `className` に対して `Class.Object:IsA()` が `true` を返す最初の子要素を返します。

見つからない場合、このメソッドは `nil` を返します。オプションで、`recursive` 引数が `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

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

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

インスタンスに関連付けられた `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` イベントと同様に動作しますが、特定の属性が変更されたときのみ発火します。
実質的に、属性用の `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("属性が変更されました")
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` の配列（数値でインデックスされたテーブル）を返します。これにより、オブジェクトと等しい `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 .. "は子要素番号" .. 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

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

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

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

- このアイテムは保護されています。`Class.Script` または `Class.LocalScript` で使用しようとするとエラーが発生します。
- デバッグ ID はデバッグプロセスで使用される ID です。デバッガーがアプリケーションが処理する前に各命令を読み取ることを可能にします。Roblox のすべてのオブジェクトはプロセスのように動作し、必要な場合はデバッグ可能な実行命令（または 'コード'）を実行します。
- これは、同じ名前を共有する類似のオブジェクトを区別する必要があるプラグインに役立つ場合があります。

Instance:GetDebugId

scopeLength

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

GetDescendants は、特定のタイプのオブジェクトのすべての子孫に対して何かを行うためにしばしば使用されます。この例のコードは GetDescendants と `Class.Instance:IsA()` を使用してワークスペース内のすべての部品を見つけ、それらを緑色に変更します。

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

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

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

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

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

このメソッドは、指定されたスタイルプロパティが変更されたときにのみ発火する `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` イベントとまったく同じ動作をするイベントを返します。プロパティ名をチェックする関数と `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` への接続を使用する代わりに、このメソッドを使用することが一般的に良いアイデアです。同じオブジェクトの同じプロパティ名でこのメソッドを subsequent 呼び出すと、同じイベントが返されます。

このイベントは、接続された関数に引数を渡さないので、変更されたプロパティの値はスクリプト内で直接読み取る必要があります。

```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/properties)ウィンドウで追加することも、実行時に
`Class.Instance:AddTag()|AddTag()`を使って追加することもできます。

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

Instance:GetTags

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

このメソッドは、指定されたタグがオブジェクトに追加されている場合は`true`を返します。タグは、スタジオの
[プロパティ](/studio/properties)ウィンドウで追加することも、実行時に
`Class.Instance:AddTag()|AddTag()`を使って追加することもできます。

Instance:HasTag

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

この例は、`Class.Instance:IsAncestorOf()`を使用して、一つのインスタンスが他のインスタンスの祖先であるかどうかを判定する方法を示しています。

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

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

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

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

詳細については、`Class.Instance:IsDescendantOf()`を参照してください。

Instance:IsAncestorOf

指定された子孫の先祖である場合は`true`。

指定された子孫の先祖であるかどうかを返します。

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

`IsDescendantOf()`は`nil`をパラメータとして使用してオブジェクトが削除されたかどうかを確認するためには使用できません。

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

Instance:IsDescendantOf

ancestor

指定された先祖の子孫である場合は`true`。

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

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

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

このメソッドが `true` を返す場合、スタイリングはプロパティに **影響しません**。明示的にプロパティを変更することがスタイリングより優先されるためです。プロパティをコードによってインスタンス化されたデフォルトにリセットしてスタイリングできるようにするには、`Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()` を使用します。


Instance:IsPropertyModified

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

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


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


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

このメソッドは、オブジェクトの `Class.Instance.Parent` を `nil` に設定し、そのすべての子孫にも同じことをします。

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

Instance:Remove

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

このメソッドは、インスタンスからタグを削除します。オブジェクトにタグがない場合はエラーをスローしません。タグを正常に削除すると、指定されたタグを含む`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に追加されるのを待ちます。

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

##### 主な使用法

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

##### 注意事項

- 呼び出し時に、指定された名前の子要素が存在する場合、このメソッドは待機しません。
- `Class.Instance:FindFirstChild()` は、存在すると仮定されるオブジェクトに対しては、`Class.Instance:WaitForChild()|WaitForChild()` よりも効率的です。
- このメソッドの呼び出しが5秒間返されずに超過した場合、タイムアウトパラメータが指定されていない場合、スレッドが無限に待機する可能性があるという警告が出力されます。

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つに対して呼び出されるとき、インスタンスが含まれるべきかどうかを決定します。インスタンスに直接 `Class.Instance:Clone()|Clone()` を呼び出すと、そのインスタンスが **not** `Class.Instance.Archivable|Archivable` の場合、`nil` が返されます。

スタジオでオブジェクトを**重複**または**コピー**/**貼り付け**オプションを使ってコピーすると、インスタンス固有の `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()` を使ってクローンできるかどうか、また保存/公開できるかどうかを決定します。

このインスタンス内でスクリプトに使用できる機能のセットです。機能が有効になるためには、`Class.Instance.Sandboxed` プロパティを有効にする必要があります。

このプロパティは、実験的な機能によって使用されます。詳細については、[スクリプトの機能](/scripting/capabilities)を参照してください。

Instance.Capabilities

このコンテナ内でスクリプトに使用できる機能のセット。

`Instance` は、`Class.DataModel` ツリーの一部となることができるロブロックスクラス階層内のすべてのクラスの基底クラスです。

/reference/engine/classes/InputContext.yaml

InputContext

概要

プロパティ

方法

イベント

プロパティ

方法

イベント

ページ内容