A **ヒンジ制限** は、2つの `Class.Attachment|Attachments` が1軸で回転し、2つの `Class.Attachment|Attachments` が同じ位置に占有し、それらの **X** 軸が同じ方向に向かっているように制限することができます。

  この制約が 1つのパーツ ( **A** ) を他のパーツ ( **B** ) に付属させる場合 ( **Z** )、パーツ **A** はプレイヤーとの対話中にローカルシミュレーションされないことに注意してください。

  この制約を構成するときは、[Roblox ユニット](/physics/units) を調べることで、Roblox ユニットがメトリックユニットと比較してどのようになるかを理解するのが役立つかもしれません。

  #### 角度パワー

  ヒンジは回転を作動させるように構成できます。ヒンジの `Class.HingeConstraint.ActuatorType|ActuatorType` が `Enum.ActuatorType|Motor` に設定されている場合、付属物を回転させて目標の `Class.HingeConstraint.AngularVelocity|AngularVelocity` に到達することを試みます。この回転をさらに制御するには、`Class.HingeConstraint.MotorMaxAcceleration|MotorMaxAcceleration` と `Class.HingeConstraint.MotorMaxTorque|MotorMaxTorque` の両方を介してできます。ヒンジの `Class.HingeConstraint.ActuatorType|ActuatorType` が `Enum.ActuatorType|Servo` に設定されている場合、`Class.HingeConstraint.TargetAngle|TargetAngle` に指定された角度に回転しようとします。この回転は、`Class.HingeConstraint.AngularSpeed|AngularSpeed` と `Class.HingeConstraint.ServoMaxTorque|ServoMaxTorque` の両方によって制御されます。

  #### 制限

  ヒンジの回転を制限する限界を設定して、ドアのようなメカニズムを制限することができ、設定範囲内でのみ開いたり閉じたりする必要があります。`Class.HingeConstraint.LimitsEnabled|LimitsEnabled` プロパティを有効にすると、`Class.HingeConstraint.LowerAngle|LowerAngle` および `Class.HingeConstraint.UpperAngle|UpperAngle` 制限と、限界に達すると付属物の弾力を定義する `Class.HingeConstraint.Restitution|Restitution` が露出します。

HingeConstraint

`Class.HingeConstraint` の回転が有効になっているかどうか、および、有効になっている場合、どのようなアクティベーションかを設定します。

  *   if `Class.HingeConstraint.ActuatorType|ActuatorType` が `Enum.ActuatorType|Motor` に設定されている場合、ヒンジは、`Class.HingeConstraint.AngularVelocity|AngularVelocity` に到達する目的で添付ファイルを回転させようとします。この回転は、`Class.HingeConstraint.MotorMaxAcceleration|MotorMaxAcceleration` と `Class.HingeConstraint.MotorMaxTorque|MotorMaxTorque` の両方に制限されています。
  *   if `Class.HingeConstraint.ActuatorType|ActuatorType` が `Enum.ActuatorType|Servo` に設定されている場合、ヒンジは `Class.HingeConstraint.TargetAngle|TargetAngle` に指定された角度に回転しようとします。この回転は、`Class.HingeConstraint.AngularSpeed|AngularSpeed` と `Class.HingeConstraint.ServoMaxTorque|ServoMaxTorque` の両方に制限されています。

  作動したフリースピンローテーションとフリースピンローテーションの両方が制限されることに注意してください。`Class.HingeConstraint.LimitsEnabled|LimitsEnabled` を真に設定して。

HingeConstraint.ActuatorType

`Class.HingeConstraint` の回転が有効になっているかどうか、および、有効になっている場合、どのようなアクティベーションを使用するかを設定します。

このプロパティは、`Class.HingeConstraint.TargetAngle|TargetAngle` に到達するときのサーボモーターの鋭さを指定し、`Class.HingeConstraint.ActuatorType|ActuatorType` が `Enum.ActuatorType|Servo` に設定されているときに、サーボモーターの鋭さを指定します。より大きな値はより速い応答に対応し、より小さな値はより多くのダンピングとより遅い応答に対応します。

HingeConstraint.AngularResponsiveness

`Class.HingeConstraint.TargetAngle|TargetAngle` に到達するサーボモーターの鋭さを指定します。

望ましい角速度 a `Class.HingeConstraint` に `Class.HingeConstraint.ActuatorType|ActuatorType` を設定し、`Enum.ActuatorType|Servo` に向かって回転すると、その `Class.HingeConstraint.TargetAngle|TargetAngle` を維持しようとします。秒単位で測定されます。

HingeConstraint.AngularSpeed

角速度 a `Class.HingeConstraint` に `Class.HingeConstraint.ActuatorType|ActuatorType` を設定し、`Enum.ActuatorType|Motor` に達成しようとします。ラディアン/秒で測定されます。

HingeConstraint.AngularVelocity

現在の角度の    。この角度は、 Y  軸の角度分離を測定して計算されます。

HingeConstraint.CurrentAngle

現在の角度の `Class.HingeConstraint` 。

`Class.HingeConstraint` が回転範囲を制限するかどうかを設定します。有効にすると、制約は `Class.HingeConstraint.CurrentAngle|CurrentAngle` のみを `Class.HingeConstraint.LowerAngle|LowerAngle` と `Class.HingeConstraint.UpperAngle|UpperAngle` の間に許可します。`Class.Attachment` が制限された回転範囲の端に到達すると、回転が停止します。`Class.HingeConstraint.Restitution|Restitution` が 0 より大きい場合、添付ファイルは制限された範囲の端に当たるとバウンスします。

HingeConstraint.LimitsEnabled

`Class.HingeConstraint` が回転範囲を制限するかどうかを設定します。

The minimum rotation angle the  `Class.HingeConstraint` は、`Class.HingeConstraint.LimitsEnabled|LimitsEnabled` が真実である場合、最小回転角を許可します。度で測定されます。

HingeConstraint.LowerAngle

The minimum rotation angle the  `Class.HingeConstraint` は、`Class.HingeConstraint.LimitsEnabled|LimitsEnabled` が真になる場合に許可する最小回転角度です。

最大角加速度 a `Class.HingeConstraint` に `Class.HingeConstraint.ActuatorType|ActuatorType` を設定し、`Enum.ActuatorType|Motor` で `Class.HingeConstraint.AngularVelocity|AngularVelocity` を達成することができます。秒単位のラディアンで測定します。

HingeConstraint.MotorMaxAcceleration

トルクの最大値は、`Class.HingeConstraint` で `Class.HingeConstraint.ActuatorType|ActuatorType` を `Enum.ActuatorType|Motor` に設定し、望む `Class.HingeConstraint.AngularVelocity|AngularVelocity` に到達しようとするときに適用できます。

HingeConstraint.MotorMaxTorque

`Class.HingeConstraint` の視覚的な半径。

HingeConstraint.Radius

どの程度柔軟な    が、   が真になると、範囲の端に到達するとき、どのようになりますか？制限は 0 と 1 の間です。

HingeConstraint.Restitution

トルクの最大値は、`Class.HingeConstraint` で `Class.HingeConstraint.ActuatorType|ActuatorType` を `Enum.ActuatorType|Servo` に設定し、望む `Class.HingeConstraint.TargetAngle|TargetAngle` に到達しようとするときに適用できます。

HingeConstraint.ServoMaxTorque

HingeConstraint.SoftlockServoUponReachingTarget

ターゲットの角度 a `Class.HingeConstraint` は、`Class.HingeConstraint.ActuatorType|ActuatorType` が `Enum.ActuatorType|Servo` に設定されている場合、回転しようとします。度で測定されます。

HingeConstraint.TargetAngle

`Class.HingeConstraint` が true である場合、`Class.HingeConstraint.LimitsEnabled|LimitsEnabled` が許可する最大回転角。度で測定されます。

HingeConstraint.UpperAngle

`Class.HingeConstraint` が true である場合、`Class.HingeConstraint.LimitsEnabled|LimitsEnabled` が許可する最大回転角度。

付属物を単一の軸に回転させるように制限します。

制約ベースのオブジェクトのベースクラス。詳細については、[移動制約](/physics/mover-constraints) と [機械制約](/physics/mechanical-constraints) を参照してください。

Constraint:GetDebugAppliedForce

bodyId

Constraint:GetDebugAppliedTorque

Constraint

このプロパティは `true` ですが、制約とその両方のパーツが `Class.Workspace` にあり、制約の `Class.Constraint.Enabled` プロパティが `true` である場合。

Constraint.Active

制限が現在世界で有効かどうかを示します。

接続されている `Class.Attachment` が `Class.Constraint.Attachment1` に

Constraint.Attachment0

`Class.Attachment` に接続されている `Class.Constraint.Attachment1` 。

接続されている `Class.Attachment` が `Class.Constraint.Attachment0` に

Constraint.Attachment1

`Class.Attachment` に接続されている `Class.Constraint.Attachment0` 。

Constraint.Color

制限が有効かどうかを切り替えます。

Constraint.Enabled

Constraint.Visible

制約ベースのオブジェクトのベースクラス。

`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` を返します。

Instance

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

/reference/engine/classes/HingeConstraint.yaml

HingeConstraint

概要

プロパティ

方法

イベント

プロパティ

ActuatorType

AngularResponsiveness

AngularSpeed

AngularVelocity

CurrentAngle

LimitsEnabled

LowerAngle

MotorMaxAcceleration

MotorMaxTorque

Radius

Restitution

ServoMaxTorque

TargetAngle

UpperAngle

方法

イベント