身体颜色是 Roblox 使用的实用对象，用于从网站加载虚拟形象身体颜色。从网站加载的虚拟形象将自动拥有与该虚拟形象的身体颜色配置相对应的体色对象。当父辈在一个角色内使用 `Class.Humanoid` 时，将颜色应用到每个指定的肢体。

BodyColors

设置头部的颜色，作为 `Datatype.BrickColor` 。

  设置此参数也将设置 `Class.BodyColors.HeadColor3` .

BodyColors.HeadColor

设置头部的颜色，作为 `Datatype.BrickColor` 。

设置头部的颜色，作为 `Datatype.Color3` 。

  设置此参数也会将头部颜色设置为最接近的 `Datatype.BrickColor`。

BodyColors.HeadColor3

设置头部的颜色，作为 `Datatype.Color3` 。

设置左臂的颜色，作为 `Datatype.BrickColor` 。

  设置这将还会设置 BodyColors.LeftArmColor3

BodyColors.LeftArmColor

设置左臂的颜色，作为 `Datatype.BrickColor` 。

设置左臂的颜色，作为 `Datatype.Color3` 。

  设置这个将还将左臂颜色设置为最接近的 `Datatype.BrickColor`。

BodyColors.LeftArmColor3

设置左臂的颜色，作为 `Datatype.Color3` 。

设置左腿的颜色，作为 `Datatype.BrickColor` 。

  设置此参数也将设置 `Class.BodyColors.LeftLegColor3` .

BodyColors.LeftLegColor

设置左腿的颜色，作为 `Datatype.BrickColor` 。

设置左腿的颜色，作为 `Datatype.Color3` 。

  设置这个将还将左腿颜色设置为最接近的 `Datatype.BrickColor`。

BodyColors.LeftLegColor3

设置左腿的颜色，作为 `Datatype.Color3` 。

设置右臂的颜色，作为 `Datatype.BrickColor` 。

  设置此参数也将设置 `Class.BodyColors.RightArmColor3` .

BodyColors.RightArmColor

设置右臂的颜色，作为 `Datatype.BrickColor` 。

设置右臂的颜色，作为 `Datatype.Color3` 。

  设置这个将还将右臂颜色设置为最接近的 `Datatype.BrickColor`。

BodyColors.RightArmColor3

设置右臂的颜色，作为 `Datatype.Color3` 。

设置右腿的颜色，作为 `Datatype.BrickColor` 。

  设置此参数也将设置 `Class.BodyColors.RightLegColor3` .

BodyColors.RightLegColor

设置右腿的颜色，作为 `Datatype.BrickColor` 。

设置右腿的颜色，作为 `Datatype.Color3` 。

  设置这个将还将右腿颜色设置为最接近的 `Datatype.BrickColor`。

BodyColors.RightLegColor3

设置右腿的颜色，作为 `Datatype.Color3` 。

设置躯干的颜色，作为 `Datatype.BrickColor` 。

  设置此参数也将设置 `Class.BodyColors.TorsoColor3` .

BodyColors.TorsoColor

设置躯干的颜色，作为 `Datatype.BrickColor` 。

设置躯干的颜色，作为 `Datatype.Color3` 。

  设置这将还将躯干颜色设置为最接近的 `Datatype.BrickColor`。

BodyColors.TorsoColor3

设置躯干的颜色，作为 `Datatype.Color3` 。

对于一个人形角色，BodyColors 将指定不同身体部位的颜色。

改变角色外观的对象的基础类。

CharacterAppearance

改变角色外观的对象的基础类，例如 `Class.BodyColors` ,  `Class.CharacterMesh` ,  `Class.ShirtGraphic` ,  `Class.Pants` 和  `Class.Shirt` 对象。

`Instance` 是 Roblox 类层次中所有类的基础类，可以组成 `Class.DataModel` 树。

  无法直接创建根 `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` 属性发生更改时，触发火焰。

  该事件包含两个参数：指向了具有>的》的》，其中》实际上已更改，而》指向了这个实例的新》。

  您可以使用此事件来跟踪 Studio 中实例的删除，例如手动删除在 Explorer 或通过插件进行。如果需要检测实例是否使用 `Class.Instance:Destroy()` 被摧毁，请使用 `Class.Instance.Destroying` 事件。

Instance.AncestryChanged

child

已更改其 `Class.Instance` 的 `Class.Instance.Parent` 。

parent

新的 `Class.Instance.Parent` 的 `Class.Instance` 其中的 `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

每当在 `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` 后发生。

  每次发射到每个后裔时，将对象父辈到 `Class.Instance` 将会独立地发射该对象和所有其子对象的事件。

  如果您仅关心 **直接子女** 的 `Class.Instance` , 请使用 `Class.Instance.ChildAdded` 。

  还见 `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: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` 的后裔被移除之前立即发生火焰。

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` 或其祖先被摧毁之前立即发生，使用 `Class.Instance:Destroy()` 摧毁。

  如果 `Class.Workspace.SignalBehavior` 属性设置为 `Enum.SignalBehavior.Deferred` ,该事件将在下一次恢复点触发,这将是在 `Class.Instance` 或其祖先之一被摧毁后,用 `Class.Instance:Destroy()` 删除。

  使用 `Enum.SignalBehavior.Deferred|Deferred` 行为连接脚本到自己的 `Class.Instance.Destroying` 事件是有问题的，因为脚本在调用回调之前会被摧毁（即不会执行）。

  当在 Studio 中删除 `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("Styled properties changed")
  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")

  -- 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()` 循环那些孩子/后裔并选择要摧毁的内容例如，以下代码示例将摧毁所有 `Class.BasePart|BaseParts` 从一个 `Class.Model` 下降：

  ```
  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` 的实例。

展示使用 `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)  --> “你好，世界”
  -- 这样做可以防止上面的线工作：
  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` 其 `Class.Instance.Name` 与给定名称相等。

  这个函数向上工作，意味着它从实例的即时 `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` 其 `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.Instance` 其 `Class.Object.ClassName` 与给定的 className 相等。

返回第一个祖先的 `Class.Instance` 为谁 `Class.Object:IsA()` 返回给定类别的真实。

  这个函数向上工作，意味着它从实例的即时 `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

返回第一个祖先的 `Class.Instance` 为谁 `Class.Object:IsA()` 返回给定类别的真实。

The below would look in Workspace for an object name "Brick". If found, it
will change the name of the object to "Foo".

返回 `Class.Instance` 的第一个孩子，用给定的名称返回，或 `nil` 如果没有这样的孩子。如果可选的 `recursive` 参数是 `true` , 这个函数搜索所有子孙，而不仅限于 `Class.Instance` 的直接子女。

  ##### 检查对象的存在

  `FindFirstChild()` 必须如果你需要在继续前验证对象存在。尝试使用 dot 运营符索引子女按名称索引时，如果子女不存在，将抛出错误。

  ```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` 相同。当使用点运营符时，如果属性共享名称，它们会在孩子之前占据优先权。

  在以下示例中，一个 被添加到 ，这也有 属性。注意到 `part.Color` 指的是 `Datatype.Color3` 属性值，而不是子 `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")  -- The child folder
  ```

  ##### 性能说明

  `Class.Instance:FindFirstChild()|FindFirstChild()` 使用点运营符比使用 dot 运营符多花费约 20% 时间，几乎是存储对象引用的 8 倍。因此，您应该避免在紧密循环或连接到 `Class.RunService.Heartbeat` 和 `Class.RunService.PreRender` 的函数中调用它。相反，将结果存储在变量中，或考虑使用 `Class.Instance.ChildAdded|ChildAdded` 或 `Class.Instance:WaitForChild()|WaitForChild()` 来检测给定名称的子域何时可用。

Instance:FindFirstChild

recursive

返回找到给定名称的 `Class.Instance` 的第一个孩子。

返回 `Class.Instance` 的第一个孩子，其 `Class.Object.ClassName|ClassName` 与给定的 `className` 相等。与 `Class.Instance:FindFirstChildWhichIsA()` 不同，这个函数只返回那些类匹配 `className` 的对象，忽略了类继承。如果未找到匹配的子，该函数返回 `nil` 。

Instance:FindFirstChildOfClass

返回 `Class.Instance` 的第一个孩子，其 `Class.Object.ClassName|ClassName` 与给定的类名相等。

返回 `Class.Instance` 为谁 `Class.Object:IsA()` 返回真实给定类别的第一个孩子。

  如果未找到匹配的子，该函数返回 `nil` 。如果可选递归性参数为真值，此函数搜索所有子孙，而不仅限于 `Class.Instance` 的直接子女。

  与 `Class.Instance:FindFirstChildOfClass()` 不同，此函数使用 `Class.Object:IsA()` ，这与类继承有关。例如：

  ```lua
  print(part:IsA("Part")) --> 真实
  print(part:IsA("BasePart")) --> 真实
  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` 。

返回 `Class.Instance` 为谁 `Class.Object:IsA()` 返回真实给定类别的第一个孩子。

返回找到的第一个子孙，使用给定的 `Class.Instance.Name` 。

  该方法已禁用且无法使用。要找到实例的第一个后裔，请考虑使用 `recursive` 参数在 `Class.Instance:FindFirstChild()` 上。

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("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` 与对象相等。使用数字或通用循环进行遍历时，阵列可以被遍历：

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

  -- 通用循环示例
  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` 的连接，用逗号分开。不考虑 `Class.DataModel` ( `game` )。例如，一个 `Class.Part` 在 `Class.Workspace` 中可能返回 `Class.Workspace.Part`。

  当调用到一个 `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 的 [属性](/studio/properties) 窗口或在运行时添加标签 `Class.Instance:AddTag()|AddTag()` .

  当您想要一次使用多个标签对实例进行操作时，此方法很有用。然而，使用此方法检查单个标签的存在是不高效的；相反，使用 `Class.Instance:HasTag()|HasTag()` 检查特定标签。

Instance:GetTags

获取应用于实例的所有标签的阵列。

该方法返回 `true` 如果提供的标签已添加到对象。您可以在 Studio 的 [属性](/studio/properties) 窗口或运行时添加标签 `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.

返回 true 如果 `Class.Instance` 是指定后裔的祖先。

  一个 `Class.Instance` 被视为对象的祖先，如果对象的 `Class.Instance.Parent` 或其父系中的一个 `Class.Instance.Parent` 被设置为 `Class.Instance` 。

  还见，`Class.Instance:IsDescendantOf()`。

Instance:IsAncestorOf

如果 `Class.Instance` 是指定后裔的祖先，则为真值。

返回 true 如果 `Class.Instance` 是指定后裔的祖先。

返回 `true` 如果 `Class.Instance` 是指定祖先的后裔。

  请注意，`IsDescendantOf()` 不能与 `nil` 的参数一起使用，以检查对象是否已删除。

  还见 `Class.Instance:IsAncestorOf()` 。

Instance:IsDescendantOf

ancestor

如果 `Class.Instance` 是指定祖先的后裔，则为真值。

返回 `true` 如果 `Class.Instance` 是指定祖先的后裔。

返回 `true` 如果存储在指定属性中的值与默认代码实例化的值相等，则返回值。例如，如果输出 属性的 指示 ，那么调用标签上的 将返回 因为 是标签创建时的默认值，而不是通过 Studio 插入工作流程插入的。

  请注意，如果此方法返回 ，那么样式将不会影响属性，因为直接修改属性取代了样式它。

Instance:IsPropertyModified

用于指示属性是否修改的 boolean 值。

返回 `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 个字符或更少。
  *   名称不允许以 **RBX** 开始，除非调用者是 Roblox 核心脚本（仅用于 Roblox）。

  当尝试将属性设置为未支持类型时，将抛出错误。

  ##### 还看到也看到

  *   `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.Instance:FindFirstChild()` 是对假设存在的对象的更高效的替代`Class.Instance:WaitForChild()|WaitForChild()`。
  *   如果调用此方法超过 5 秒而未返回，且未指定任何 `timeOut` 参数，将在输出上打印警告，说明线程可能无限期生成。

Instance:WaitForChild

childName

timeOut

返回 `Class.Instance` 的孩子与给定名称。如果孩子不存在，它将生成当前线程直到它存在。

子女函数返回对象的子女阵列。

Instance:children

Instance:clone

Instance:destroy

Instance:findFirstChild

Instance

`Instance` 是 Roblox 类层次中所有类的基础类，可以组成 `Class.DataModel` 树。

/reference/engine/classes/BodyColors.yaml

BodyColors

概要

属性

方法

活动

属性

方法

活动

在此页面