Este exemplo mostra a configuração básica para um `Class.IKControl` que move o
braço esquerdo de um personagem para alcançar um ponto no mundo.

**IKControl** instâncias geram poses de animação procedural usando Inverse
Kinematics (IK). Elas permitem que você faça com que personagens respondam de forma realista ao
seu ambiente.

Por exemplo, você pode fazer um personagem colocar sua mão em uma maçaneta exatamente,
e o personagem fará isso independentemente de sua posição.
`Class.IKControl|IKControls` fornecem a vantagem de precisar criar muito
menos animações para seu jogo, ao mesmo tempo que conferem à sua experiência um toque mais realista
 e polido.

`Class.IKControl|IKControls` devem ser filhos de um `Class.Humanoid` ou
`Class.AnimationController` com um `Class.Animator` e ter todas as suas
propriedades necessárias definidas corretamente; caso contrário, não terão efeito. As
propriedades necessárias são `Class.IKControl.Type|Type`,
`Class.IKControl.EndEffector|EndEffector`, `Class.IKControl.Target|Target`,
e `Class.IKControl.ChainRoot|ChainRoot`. Assim que estas estão definidas, o
`Class.IKControl` modifica a pose do seu personagem como você especificar. O
seguinte exemplo de código demonstra como configurar seu primeiro `Class.IKControl`
e começar a criar animações mais realistas para o seu jogo.

Você pode usar `Class.IKControl|IKControls` para fazer um personagem:

- Rotacionar sua cabeça e torso para olhar para um ponto de interesse no mundo.
- Modificar as posições de seus pés para responder a terrenos dinâmicos. Ajustar suas pernas e
  pés para colocá-los adequadamente em terrenos com pedras e inclinações.
- Segurar uma arma e posicionar suas mãos apropriadamente no empunhadura sem precisar
  criar animações para cada arma do jogo.
- Mirar para um ponto no mundo, de modo que a ponta da arma aponte exatamente para
  o que você deseja atingir. Especialmente útil em jogos de tiro em terceira pessoa.
- Colocar suas mãos no volante de um carro e segui-lo quando ele
  rotaciona.
- Muito mais!

`Class.IKControl` irá substituir a animação para todas as partes entre o
`Class.IKControl.ChainRoot|ChainRoot` e o
`Class.IKControl.EndEffector|EndEffector`. Você pode habilitá-lo/desabilitá-lo usando
`Class.IKControl.Enabled|Enabled` ou mudar quanto eles têm efeito sobre
 a animação subjacente usando o `Class.IKControl.Weight|Weight`. Tenha
cuidado: se você não configurar seus `Class.IKControl|IKControls` corretamente,
você poderá gerar poses ruins e não realistas!

IKControl:GetChainCount

IKControl:GetChainLength

IKControl:GetNodeLocalCFrame

index

IKControl:GetNodeWorldCFrame

IKControl:GetRawFinalTarget

IKControl:GetSmoothedFinalTarget

IKControl

Ao especificar um `Class.IKControl.ChainRoot|ChainRoot` e um
`Class.IKControl.EndEffector|EndEffector`, você instrui o
`Class.IKControl` que ele pode mover e rotacionar todas as partes entre
o dois para mover o `Class.IKControl.EndEffector|EndEffector` para o
`Class.IKControl.Target|Target`. Por exemplo, se você especificar a MãoEsquerda
como `Class.IKControl.EndEffector|EndEffector` e BraçoSuperiorEsquerdo como o
`Class.IKControl.ChainRoot|ChainRoot`, o controle move 3 partes: a
MãoEsquerda, o BraçoInferiorEsquerdo, e o BraçoSuperiorEsquerdo. Evite definir
`Class.IKControl.ChainRoot|ChainRoot` como a raiz real do personagem
porque isso produz resultados não realistas.

IKControl.ChainRoot

A última parte que você está interessado em mover seu personagem. Por
exemplo, o braço superior. Deve ser um ancestral de
`Class.IKControl.EndEffector|EndEffector` e ser uma `Class.BasePart` ou um
`Class.Bone` em seu personagem.

Esta propriedade permite que você ative ou desative o controle de IK. Está ativado por
default. Quando `Class.IKControl.Enabled|Enabled` é falso, o controle de IK
está desligado e não é resolvido pelo solucionador subjacente.

IKControl.Enabled

Alterna o controle ligado e desligado. Verdadeiro por padrão.

O `Class.IKControl.EndEffector|EndEffector` descreve a última parte na
the chain do seu personagem que você deseja afetar. Por exemplo, pode ser
 a mão quando você quer mover todo o braço para alcançar um ponto. Pode
ser uma `Class.BasePart` em um personagem, que possui um `Class.Motor6D` como
seu filho, um `Class.Motor6D` diretamente, um `Class.Bone`, ou um
`Class.Attachment`. O pivô do selecionado
`Class.IKControl.EndEffector|EndEffector` se muda para o
`Class.IKControl.Target|Target`, assim você pode usar
`Class.Attachment|Attachments` para modificar qual ponto de uma `Class.BasePart`
deve alcançar o `Class.IKControl.Target|Target`.

IKControl.EndEffector

A parte que você está interessado em mover para alcançar o
`Class.IKControl.Target|Target`. Por exemplo, a mão do seu personagem.
Deve ser um descendente de `Class.IKControl.ChainRoot|ChainRoot` e ser uma
`Class.BasePart` ou um `Class.Bone` em seu personagem.

O deslocamento do efeito final é um `Datatype.CFrame` adicional aplicado sobre
 o `Class.IKControl.Target|Target` `Datatype.CFrame` que produz o
`Datatype.CFrame` final usado para posicionar o
`Class.IKControl.EndEffector|EndEffector`. Por padrão, é o CFrame identidade,
 então se você não configurá-lo, isso não terá efeito e o
`Class.IKControl.EndEffector|EndEffector` usará diretamente o `Class.IKControl.Target|Target`
`Datatype.CFrame`, que é especificado no espaço local do
`Class.IKControl.EndEffector|EndEffector`.

Alternativamente, você pode usar Attachments configurando um Attachment como
`Class.IKControl.EndEffector|EndEffector`, que o move para o
`Class.IKControl.Target|Target` ao invés das partes às quais está conectado,
obtendo efetivamente o mesmo resultado.

Você também pode usar `Class.IKControl.EndEffectorOffset|EndEffectorOffset` para
modificar qual eixo do `Class.IKControl.EndEffector|EndEffector` deve
apontar para o `Class.IKControl.Target|Target` ao usar `LookAt` como
`Class.IKControl.Type|Type`.

IKControl.EndEffectorOffset

Um deslocamento adicional aplicado ao
`Class.IKControl.EndEffector|EndEffector` em seu espaço local para mudar
 onde ele se move.

O deslocamento é um `Datatype.CFrame` adicional aplicado ao `Class.IKControl.Target|Target`
`Datatype.CFrame` que produz o `Datatype.CFrame` final usado para posicionar o
`Class.IKControl.EndEffector|EndEffector`. É identidade por padrão, então se
você não configurá-lo, não terá efeito e o
`Class.IKControl.EndEffector|EndEffector` usará diretamente o
`Class.IKControl.Target|Target` `Datatype.CFrame`. Você pode
animá-lo para criar animações procedurais, como digitar em um teclado.
É útil quando o `Class.IKControl.Target|Target` e o
`Class.IKControl.EndEffector|EndEffector` não estão alinhados e você precisa
corrigi-lo com uma rotação ou translação adicional.

IKControl.Offset

Um deslocamento adicional aplicado ao `Class.IKControl.Target|Target`
para mudar onde o `Class.IKControl.EndEffector|EndEffector` se move.

O `Class.IKControl.Pole|Pole` é uma `Class.Instance` opcional que lhe dá
controle sobre como as partes intermediárias no seu personagem devem se curvar. Pode
ser qualquer coisa que tenha uma posição no mundo, como
`Class.BasePart`, `Class.Attachment`, `Class.Bone`, `Class.Motor6D`. É
por padrão `nil`. Quando você especifica, o solucionador subjacente fará com que as
 partes se curvem em direção a ele. Quando é `nil`, o solucionador tentará fazer
 cotovelos e joelhos se curvarem de forma apropriada, com base no membro do personagem.
O membro será "Braço" quando você selecionar como
`Class.IKControl.EndEffector|EndEffector` ou a _MãoEsquerda_ ou
_MãoDireita_ e como `Class.IKControl.ChainRoot|ChainRoot` o correspondente
_BraçoSuperiorEsquerdo_ ou _BraçoSuperiorDireito_, e será "Perna" quando você selecionar como
`Class.IKControl.EndEffector|EndEffector` ou o _PéEsquerdo_ ou
_PéDireito_ e como `Class.IKControl.ChainRoot|ChainRoot` o correspondente
_BraçoInferiorEsquerdo_ ou _BraçoInferiorDireito_. Em todos os outros casos, se você não
especificar um pole, a cadeia pode não se curvar como você espera.

IKControl.Pole

Uma instância opcional que determina de que forma a cadeia se curva. Você pode
usar isso para especificar de que forma um cotovelo ou joelho se curva.

Quando múltiplos controles estão ativos em um personagem, a ordem em que eles
são resolvidos pelo sistema subjacente afeta a pose final gerada. Ao
mudar este valor, você especifica a ordenação em que os controles são
satisfeitos. Valores mais altos têm maior prioridade, e controles de maior prioridade
são resolvidos por último, pois seu resultado pode sobrepor o
resultado anterior de outros controles. Se você tiver múltiplos controles de IK em um
personagem e um for mais importante que o outro, especifique uma prioridade menor
para ele. É 0 por padrão, o que significa que todos os controles têm a mesma
prioridade.

IKControl.Priority

Especifica a ordem em que os controles são resolvidos. Valores mais altos têm
maior prioridade.

Este valor especifica o número médio de segundos que leva para o
`Class.IKControl.EndEffector|EndEffector` alcançar o
`Class.IKControl.Target|Target`. O comportamento é o de uma
mola criticamente amortecida, onde a taxa de mudança é proporcional à
distância ao alvo e não há oscilações presentes ao se aproximar
do alvo. Valores menores criam uma convergência mais rápida, enquanto valores maiores
criam uma convergência mais lenta. Um valor de 0 desativa a suavização. O valor padrão
é 0.05 para proporcionar uma suavização muito leve que faz o movimento
parecer realista.

IKControl.SmoothTime

Especifica o número médio de segundos que leva para o
`Class.IKControl.EndEffector|EndEffector` alcançar suavemente o
`Class.IKControl.Target|Target`.

O `Class.IKControl.Target|Target` representa um ponto (`Datatype.CFrame`)
no mundo que você deseja que seu `Class.IKControl.EndEffector|EndEffector`
alcance. O comportamento exato de alcance pode ser definido pela
propriedade `Class.IKControl.Type|Type`, e um adicional
`Class.IKControl.Offset|Offset` pode ser aplicado a ele para modificá-lo.
Se você definir um `Class.IKControl.Target|Target` que será movido por
física ou um script, a cada quadro o `Class.IKControl` tentará
satisfazê-lo, atualizando automaticamente o ponto a ser alcançado.

IKControl.Target

O objeto que o `Class.IKControl.EndEffector|EndEffector` alcança
ou aponta. Pode ser qualquer coisa que tenha uma posição no mundo, como
`Class.BasePart`, `Class.Attachment`, `Class.Bone`, ou `Class.Motor6D`.

Ao mudar o `Class.IKControl.Type|Type`, você pode alterar o comportamento
do controle. Estas são as opções disponíveis:

- Transform: é uma restrição total de 6 graus de liberdade. Alinha o
  `Class.IKControl.EndEffector|EndEffector` `Datatype.CFrame` ao do
  `Class.IKControl.Target|Target`.
- Position: alinha a posição do `Class.IKControl.EndEffector|EndEffector`
ao do `Class.IKControl.Target|Target`.
- Rotation: alinha a rotação do `Class.IKControl.EndEffector|EndEffector`
ao do `Class.IKControl.Target|Target`.
- LookAt: move e orienta toda a cadeia para fazer um eixo (por padrão
  o eixo da frente) no `Class.IKControl.EndEffector|EndEffector` apontar
  para uma posição no mundo especificada por `Class.IKControl.Target|Target`.

IKControl.Type

Especifica como o solucionador satisfaz este controle.

Você pode controlar quanto um determinado controle afeta a pose do personagem usando
esta propriedade. Os valores devem estar na faixa [0, 1]. 0 significa nenhum
efeito, e 1 significa efeito total do controle de IK. Valores fora desta
faixa são truncados. Variar suavemente este valor permite que você faça a transição
para dentro ou fora de um controle específico para evitar movimentos bruscos. É 1 por padrão.

O peso determina o fator de interpolação entre o Efeito Final
 e o alvo IK. Configurar o peso para 0 não desativa o Controle de IK
porque outros fatores, incluindo o fator de suavização SmoothTime e Pole,
podem ainda mudar a pose. Para realmente desativar o Controle de IK, altere a
propriedade `Class.IKControl.Enabled|Enabled` para falso.

IKControl.Weight

Especifica o peso do alvo do controle de IK. Deve estar na faixa [0, 1].

Especifica um controle para gerar uma pose de animação procedural usando Inverse
Kinematics.

`Instance` é a classe base para todas as classes na hierarquia de classes do Roblox
que podem fazer parte da árvore `Class.DataModel`.

Não é possível criar diretamente objetos `Instance` raiz, mas o construtor especial
`Datatype.Instance.new()` cria objetos via código, recebendo o
nome da classe como um parâmetro e retornando o objeto criado.

Demonstra como detectar mudanças na ancestralidade de uma instância conectando-se ao
`Class.Instance.AncestryChanged` evento.

O Parent do ChangingPart é definido para valores diferentes ao longo do tempo. O pai da
peça é o ancestral da peça, então o evento `Class.Instance.AncestryChanged`
será acionado sempre que mudar.


Dispara quando esta instância é reparentada ou quando qualquer um de seus
ancestrais é reparentado.

Você pode usar este evento para rastrear a exclusão de uma instância no
Studio, como exclusão manual no Explorer ou por meio de um plugin. Se
você precisar detectar quando uma instância é destruída usando
`Class.Instance:Destroy()`, use o evento `Class.Instance.Destroying`
em vez disso.

Instance.AncestryChanged

child

A instância cuja propriedade `Class.Instance.Parent|Parent` foi alterada,
que pode ser esta instância ou um ancestral mais distante, **não**
necessariamente a instância à qual o manipulador está conectado.

parent

Dispara quando a propriedade `Class.Instance.Parent` deste objeto ou um de
seus ancestrais é alterada.

Este evento dispara sempre que qualquer atributo é alterado na instância,
 incluindo quando um atributo é definido como `nil`. O nome do atribuito que foi
alterado é passado para a função conectada.

Por exemplo, o seguinte trecho de código conecta a função
`attributeChanged()` para disparar sempre que um dos atributos do
objeto muda:

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

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "mudou")
end

part.AttributeChanged:Connect(attributeChanged)
```
Veja também `Class.Instance:GetAttributeChangedSignal()` que retorna um
evento que dispara quando um atributo específico é alterado.

Instance.AttributeChanged

attribute

Dispara sempre que um atributo é alterado na `Class.Instance`.

Este trecho imprime os nomes dos objetos à medida que são adicionados ao Workspace:

Dispara após um objeto ser parentado a esta `Class.Instance`.

Observe que, ao usar este método em um cliente para detectar objetos
criados pelo servidor, é necessário usar `Class.Instance:WaitForChild()` ao
indexar os descendentes desses objetos. Isso ocorre porque o objeto e seus
descendentes não são garantidos a serem replicados do servidor para o cliente
simultaneamente. Por exemplo:

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

Workspace.ChildAdded:Connect(function(child)
	-- Use WaitForChild() já que os descendentes podem não ter sido replicados ainda
	local head = child:WaitForChild("Head")
end)
```
Observe que este evento opera apenas para filhos imediatos do
`Class.Instance`. Para um evento que captura todos os descendentes, use
`Class.Instance.DescendantAdded`.

Veja também `Class.Instance.ChildRemoved`.

Instance.ChildAdded

Dispara após um objeto ser parentado a esta `Class.Instance`.

Instance.childAdded

Este trecho imprime os nomes dos objetos à medida que são removidos do
Workspace:

Dispara após um filho ser removido deste `Class.Instance`.

Removido refere-se a quando o pai de um objeto é alterado de
este `Class.Instance` para algo diferente deste `Class.Instance`. Observe que,
este evento também disparará quando um filho for destruído (usando
`Class.Instance:Destroy()`), já que a função de destruição define o pai de um objeto como `nil`.

Este evento opera apenas para filhos imediatos do `Class.Instance`.
Para um evento que captura todos os descendentes, use
`Class.Instance.DescendantRemoving`.

Veja também `Class.Instance.ChildAdded`.

Instance.ChildRemoved

Dispara após um filho ser removido deste `Class.Instance`.

Este exemplo a seguir imprimirá o nome de qualquer objeto que for adicionado ao
Espaço de Trabalho:

Este evento dispara após um descendente ser adicionado à `Class.Instance`.

Como ele dispara para cada descendente, parentear um objeto à
`Class.Instance` fará com que o evento dispare para este objeto e todos os seus
descendentes individualmente.

Se você está apenas preocupado com os **filhos diretos** do
`Class.Instance`, use `Class.Instance.ChildAdded` em vez disso.

Veja também `Class.Instance.DescendantRemoving`.

Instance.DescendantAdded

descendant

Dispara após um descendente ser adicionado à `Class.Instance`.

O seguinte exemplo imprime o nome de qualquer descendente enquanto está sendo removido
do Workspace:

Este evento dispara **imediatamente antes** de o pai `Class.Instance`
ser alterado de forma que uma instância **descendente** não será mais um
descendente. `Class.Instance:Destroy()|Destroy()` altera o
`Class.Instance.Parent|Parent` de uma instância para `nil`, então chamar esse método em um
descendente do pai fará com que este evento dispare.

Como este evento dispara **antes** da remoção do descendente, o pai do
descendente permanecerá inalterado no momento da disparação deste evento. Se o
descendente também for um **filho direto** do pai, este evento disparará
antes de `Class.Instance.ChildRemoved`.

Se um descendente tiver filhos, este evento dispara primeiro com o descendente,
seguido por seus descendentes.

#### Aviso

Este evento dispara com o objeto descendente que está sendo removido.
Tentar definir o `Class.Instance.Parent|Parent` do descendente para
algo diferente falhará. Abaixo está um exemplo que demonstra isso:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Não manipule o pai do descendente nesta função!
	-- Este evento dispara POR CAUSA de a parentagem ter sido manipulada, e a alteração
	-- ainda não aconteceu
	-- Portanto, é problemático alterar o pai assim:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Veja também `Class.Instance.DescendantAdded|DescendantAdded`.

Instance.DescendantRemoving

O `Class.Instance` que está sendo removido.

Dispara imediatamente antes de um descendente do `Class.Instance` ser removido.

Este exemplo demonstra como, ao usar o comportamento de sinal Imediato, uma
Instância sendo destruída permanece no lugar até que a função conectada faça yield.


Este exemplo demonstra como, ao usar o comportamento de sinal Deferred, uma Instância
é destruída antes que o sinal seja acionado.


O `Class.Instance` nunca será excluído da memória enquanto uma função conectada
estiver ainda usando-o. No entanto, se a função pausar em algum momento,
o `Class.Instance` e seus descendentes serão parentados para `nil`.

Se a propriedade `Class.Workspace.SignalBehavior` estiver definida como
`Enum.SignalBehavior.Immediate`, este evento dispara imediatamente antes do
`Class.Instance` ou um de seus ancestrais ser destruído com
`Class.Instance:Destroy()`.

Se a propriedade `Class.Workspace.SignalBehavior` estiver definida como
`Enum.SignalBehavior.Deferred`, este evento dispara no próximo
ponto de retomar, que será após o `Class.Instance` ou um de seus
ancestrais serem destruídos com `Class.Instance:Destroy()`.

Com o comportamento `Enum.SignalBehavior.Deferred|Deferred`, conectar um script
ao seu próprio evento `Class.Instance.Destroying` é problemático, já que o script
será destruído antes que o callback possa ser chamado (o que significa que não
será executado).

Ao excluir um `Class.Instance` no Studio, como excluir manualmente
por meio do [Explorer](/studio/explorer) ou por meio de um plugin,
o `Class.Instance` não é destruído. Em vez disso, o pai é definido como `nil`
que você pode rastrear com `Class.Instance.AncestryChanged`.

Instance.Destroying

Dispara imediatamente antes (ou é adiado até depois) da instância ser
 destruída através de `Class.Instance:Destroy()`.

Este evento dispara sempre que qualquer propriedade de estilo é alterada na instância,
incluindo quando uma propriedade é definida como `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("Propriedades de estilo alteradas")
end

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

Instance.StyledPropertiesChanged

Dispara sempre que qualquer propriedade de estilo é alterada na instância, incluindo
quando uma propriedade é definida como `nil`.

Este método aplica uma tag à instância, sem efeito se a tag já estiver
aplicada. Adicionar uma tag com sucesso acionará um sinal criado por
`Class.CollectionService:GetInstanceAddedSignal()` com a tag fornecida.

#### Avisos

- As tags de uma instância que foram adicionadas do lado do cliente serão
  descartadas se o servidor posteriormente adicionar ou remover uma tag nessa
  instância, porque o servidor replica todas as tags juntas e
  sobrepõe as tags anteriores.

- Ao marcar uma instância, é comum que alguns recursos sejam usados para
dar funcionalidade à tag, por exemplo, conexões de eventos ou tabelas.
  Para evitar vazamentos de memória, é uma boa ideia limpar esses recursos
enquanto não forem mais necessários para uma tag. Faça isso ao
  chamar `Class.Instance:RemoveTag()`, chamando
  `Class.Instance:Destroy()`, ou em uma função conectada a um sinal
  retornado por `Class.CollectionService:GetInstanceRemovedSignal()`.

Instance:AddTag

A função filhos retorna um array dos filhos do objeto.

Instance:children

Este método destrói todos os filhos e descendentes de uma instância.

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

-- Adiciona alguns brilhos
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
```
Se você não desejar destruir **todos** os filhos e descendentes, use
`Class.Instance:GetChildren()` ou `Class.Instance:GetDescendants()` para
desloopar esses filhos/descendentes e selecionar o que deve ser destruído. Por
exemplo, o seguinte exemplo de código destruirá todos os`Class.BasePart|BaseParts`
descendentes de um `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

Este método destrói todos os filhos de uma instância.

Demonstra como clonar um modelo usando `Class.Instance:Clone()`.

`Clone()` cria uma cópia de uma instância e todos os seus descendentes,
ignorando todas as instâncias que não são
`Class.Instance.Archivable|Archivable`. A cópia da instância raiz é
retornada por este método e seu `Class.Instance.Parent|Parent` é definido como
`nil`. Observe que, se a própria instância tiver
`Class.Instance.Archivable|Archivable` definido como `false`, este método
retornará `nil`.

Se uma propriedade de referência, como `Class.ObjectValue.Value`, estiver definida em uma
instância clonada, o valor da propriedade da cópia depende do valor do
original:

- Se uma propriedade de referência se referir a uma instância que também foi
  clonada, a cópia se referirá à cópia.
- Se uma propriedade de referência se referir a uma instância que **não** foi clonada,
  o mesmo valor é mantido na cópia.

Instance:Clone

Cria uma cópia de uma instância e todos os seus descendentes, ignorando instâncias
que não são `Class.Instance.Archivable|Archivable`.

Instance:clone

Demonstra a destruição de uma Parte usando a função `Class.Instance:Destroy()`.

Esta função é a maneira correta de descartar objetos que não são mais
necessários.


Define a propriedade `Class.Instance.Parent` como `nil`, tranca a
propriedade `Class.Instance.Parent`, desconecta todas as conexões e chama
`Destroy()` em todos os filhos. Este método é a maneira correta de descartar
objetos que não são mais necessários.

Descartar objetos desnecessários é importante, uma vez que objetos e
conexões desnecessárias em um lugar ocupam memória que pode levar a sérios problemas de
desempenho ao longo do tempo.

Como uma boa prática, após chamar `Destroy()` em um objeto, defina qualquer
variável que referencia o objeto (ou seus descendentes) como `nil`. Isso
impede que seu código acesse qualquer coisa relacionada ao objeto.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- Não faça isso:
print(part.Name)  --> "Hello, world"
-- Faça isso para evitar que a linha acima funcione:
part = nil
```
Uma vez que uma `Class.Instance` tenha sido destruída por este método, não pode ser
reutilizada porque a propriedade `Class.Instance.Parent` é trancada. Para
remover **temporariamente** um objeto em vez de destruí-lo, defina
`Class.Instance.Parent|Parent` como `nil`. Por exemplo:

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Para destruir um objeto após um tempo determinado, use
`Class.Debris:AddItem()`.

Instance:Destroy

Define a propriedade `Class.Instance.Parent` como `nil`, tranca a
propriedade `Class.Instance.Parent`, desconecta todas as conexões e chama
`Destroy()` em todos os filhos.

Instance:destroy

Retorna o primeiro ancestral da `Class.Instance` cujo
`Class.Instance.Name` é igual ao nome fornecido.

Este método funciona para cima, o que significa que começa no
`Class.Instance.Parent` imediato da instância e sobe em direção ao
`Class.DataModel`. Se nenhum ancestral correspondente for encontrado, retorna
`nil`.

O seguinte trecho de código encontraria o primeiro ancestral do objeto
chamado `Car`.

```
local car = object:FindFirstAncestor("Car")
```
Para variantes deste método que encontram ancestrais de uma classe específica,
veja `Class.Instance:FindFirstAncestorOfClass()` e
`Class.Instance:FindFirstAncestorWhichIsA()`.

Instance:FindFirstAncestor

name

Retorna o primeiro ancestral da `Class.Instance` cujo
`Class.Instance.Name` é igual ao nome fornecido.

Retorna o primeiro ancestral da `Class.Instance` cujo
`Class.Object.ClassName` é igual ao nome da classe fornecida.

Este método funciona para cima, o que significa que começa no
`Class.Instance.Parent` imediato da instância e sobe em direção ao
`Class.DataModel`. Se nenhum ancestral correspondente for encontrado, retorna `nil`.

Um uso comum deste método é encontrar o `Class.Model` a que um
`Class.BasePart` pertence. Por exemplo:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Este método é uma variante de `Class.Instance:FindFirstAncestor()` que
verifica a propriedade `Class.Object.ClassName` em vez de
`Class.Instance.Name`. `Class.Instance:FindFirstAncestorWhichIsA()` também
existe, usando o método `Class.Object:IsA()` em vez disso para respeitar a
herança de classe.

Instance:FindFirstAncestorOfClass

className

O `Class.Object.ClassName` a ser procurado.

Retorna o primeiro ancestral da `Class.Instance` cujo
`Class.Object.ClassName` é igual ao nome da classe fornecida.

Retorna o primeiro ancestral da `Class.Instance` para quem
`Class.Object:IsA()` retorna verdadeiro para o nome da classe fornecida.

Este método funciona para cima, o que significa que começa no
`Class.Instance.Parent` imediato da instância e sobe em direção ao
`Class.DataModel`. Se nenhum ancestral correspondente for encontrado, retorna
`nil`.

Diferente de `Class.Instance:FindFirstAncestorOfClass()`, este método usa
`Class.Object:IsA()` que respeita a herança de classe. Por exemplo:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Portanto, o seguinte exemplo de código retornará o primeiro
ancestral `Class.BasePart`, independentemente de ser um `Class.WedgePart`,
`Class.MeshPart` ou `Class.Part`.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Veja também `Class.Instance:FindFirstAncestor()`.

Instance:FindFirstAncestorWhichIsA

Retorna o primeiro ancestral da `Class.Instance` para quem
`Class.Object:IsA()` retorna verdadeiro para o nome da classe fornecida.

O abaixo procurará no Workspace por um objeto chamado "Brick". Se encontrado, ele
mudará o nome do objeto para "Foo".

Retorna o primeiro filho da `Class.Instance` com o nome fornecido, ou
`nil` se não existir tal filho. Se o argumento opcional `recursive` for
`true`, este método busca todos os descendentes em vez de apenas os
filhos imediatos da `Class.Instance`.

#### Verificando a Existência de um Objeto

`FindFirstChild()` é necessário se você precisa verificar se um objeto existe
antes de continuar. Tentar indexar um filho pelo nome usando o operador de ponto
gera um erro se o filho não existir.

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

-- A linha a seguir gera um erro se a parte não existir no workspace
Workspace.Part.Transparency = 0.5
```
Uma abordagem melhor é usar `FindFirstChild()` para primeiro verificar o `Part`,
seguido de uma instrução `if` para executar o código que precisa dele.

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

local part = Workspace:FindFirstChild("Part")
if part then
	part.Transparency = 0.5
end
```

#### Encontrando um Filho Cujo Nome Corresponde a uma Propriedade

Às vezes o `Class.Instance.Name|Name` de um objeto é o mesmo que o de uma
propriedade do seu `Class.Instance.Parent|Parent`. Ao usar o operador de ponto,
propriedades têm precedência sobre filhos se compartilharem um nome.

No exemplo a seguir, uma `Class.Folder` chamada `Color` é adicionada a um
`Class.Part`, que também tem a propriedade `Class.Part.Color`. Observe que
`part.Color` se refere ao valor da propriedade `Datatype.Color3`, não à instância do filho
`Class.Folder`. Uma vantagem de usar
`Class.Instance:FindFirstChild()|FindFirstChild()` é que a introdução de novas
propriedades não impõe risco ao seu código.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- A propriedade
local c2 = part:FindFirstChild("Color")  -- A pasta filha
```

#### Notas de Desempenho

`Class.Instance:FindFirstChild()|FindFirstChild()` leva cerca de 20% mais
com tempo do que usar o operador de ponto e quase 8 vezes mais do que apenas armazenar
uma referência a um objeto. Portanto, você deve evitar chamá-lo em
código dependente de desempenho, como em loops apertados ou funções conectadas
a `Class.RunService.Heartbeat` e `Class.RunService.PreRender`. Em vez disso,
estocou o resultado em uma variável, ou considere usar
`Class.Instance.ChildAdded|ChildAdded` ou
`Class.Instance:WaitForChild()|WaitForChild()` para detectar quando um filho de um
dado nome se torna disponível.

Instance:FindFirstChild

recursive

Se a busca deve ser realizada recursivamente.

Retorna o primeiro filho da `Class.Instance` encontrado com o nome fornecido.

Instance:findFirstChild

Retorna o primeiro filho da `Class.Instance` cuja
`Class.Object.ClassName|ClassName` é igual ao `className` fornecido.
Diferente de `Class.Instance:FindFirstChildWhichIsA()`, este método só
retorna objetos cuja classe corresponde ao `className`, ignorando a herança
de classe. Se nenhum filho correspondente for encontrado, este método
retorna `nil`.

Instance:FindFirstChildOfClass

Retorna o primeiro filho da `Class.Instance` cuja
`Class.Object.ClassName|ClassName` é igual ao nome da classe fornecida.

Retorna o primeiro filho da `Class.Instance` para quem
`Class.Object:IsA()` retorna verdadeiro para o nome da classe fornecida.

Se nenhum filho correspondente for encontrado, este método retorna `nil`. Se o argumento
o opcional recursivo for `true`, este método busca todos os descendentes em vez
apenas dos filhos imediatos da `Class.Instance`.

Diferente de `Class.Instance:FindFirstChildOfClass()`, este método usa
`Class.Object:IsA()` que respeita a herança de classe. Por exemplo:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Portanto, o seguinte exemplo de código retornará o primeiro
filho `Class.BasePart`, independentemente de ser um `Class.WedgePart`,
`Class.MeshPart` ou `Class.Part`.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Desenvolvedores que procuram um filho pelo nome devem usar
`Class.Instance:FindFirstChild()` em vez disso.

Instance:FindFirstChildWhichIsA

Retorna o primeiro filho da `Class.Instance` para quem
`Class.Object:IsA()` retorna verdadeiro para o nome da classe fornecida.

Retorna o primeiro descendente encontrado com o dado `Class.Instance.Name`.

Este método está desabilitado e não pode ser usado. Para encontrar o primeiro descendente
 de uma instância, considere usar o parâmetro `recursive` em
 `Class.Instance:FindFirstChild()` em vez disso.

Instance:FindFirstDescendant

Retorna o primeiro descendente encontrado com o dado `Class.Instance.Name`.

Se a `Class.Instance` for um `Class.Actor`, o próprio `Class.Actor` é
retornado. Caso contrário, seu ancestral `Class.Actor` mais próximo é retornado. Se nenhum
ancestral for um `Class.Actor`, o resultado é `nil`.

Instance:GetActor

Retorna o `Class.Actor` associado à Instância, se houver.

Este método retorna o valor que foi atribuído ao nome do atributo fornecido. Se
nenhum atributo foi atribuído, `nil` é retornado.

Por exemplo, o seguinte trecho de código define e depois obtém o valor do
atributo `InitialPosition` da instância:

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

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

local initialPosition = instance:GetAttribute("InitialPosition")
print(initialPosition)
```

#### Veja Também

- `Class.Instance:SetAttribute()` que define o atributo com o nome fornecido
  para o valor fornecido.
- `Class.Instance:GetAttributes()` que retorna um dicionário de pares chave-valor
  para cada um dos atributos da instância.

Instance:GetAttribute

O nome do atributo que está sendo recuperado.

O valor que foi atribuído ao nome do atributo fornecido. Se nenhum
atributo foi atribuído, `nil` é retornado.

Retorna o valor que foi atribuído ao nome do atributo fornecido.

Este método retorna um evento que se comporta exatamente como o
evento `Class.Object.Changed|Changed`, exceto que ele só é acionado quando o
atributo específico fornecido muda; efetivamente é similar a
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` mas
para atributos.

É geralmente uma boa ideia usar este método em vez de uma conexão para
`Class.Object.Changed|Changed` com uma função que verifica o nome do atributo.
Chamadas subsequentes para este método no mesmo objeto com o mesmo
nome de atributo retornam o mesmo evento.

O seguinte exemplo de código retorna um sinal que dispara a função
`attributeChanged()` quando o atributo `InitialPosition` da parte muda:

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

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

local function attributeChanged()
	print("Atributo alterado")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
Veja também `Class.Instance.AttributeChanged` que é acionado sempre que qualquer
atributo é alterado na instância.

Instance:GetAttributeChangedSignal

O nome do atributo especificado para o qual o sinal de mudança está
sendo retornado.

Um evento que é acionado quando o atributo fornecido muda.

Retorna um evento que é acionado quando o atributo fornecido muda.

Este método retorna um dicionário de pares chave-valor para cada atributo
onde a chave é o nome do atributo e o valor é um valor não-nulo.

Por exemplo, o seguinte trecho de código exibe os atributos
 e valores de uma instância:

```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
```
Veja também `Class.Instance:GetAttribute()` que retorna o valor que foi
atribuído ao nome do atributo fornecido.

Instance:GetAttributes

Um dicionário de pares string → variante para cada atributo onde a
string é o nome do atributo e a variante é um valor não-nulo.

Retorna um dicionário dos atributos da instância.

O abaixo imprimiria o nome de todos os objetos atualmente no Workspace quando executado.

Retorna um array (uma tabela indexada numericamente) contendo todos os
filhos diretos da instância, ou cada `Class.Instance` cujo
`Class.Instance.Parent|Parent` é igual ao objeto. O array pode ser
iterado usando um loop numérico ou genérico:

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

-- Exemplo de loop numérico
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " é filho número " .. i)
end
```

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

-- Exemplo de loop genérico
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " é filho número " .. i)
end
```
Observe que o array retornado **não** é ordenado em nenhuma ordem particular, então
uma ordenação manual (por exemplo, usando `Library.table.sort()`) é recomendada para
ordenar os filhos retornados por este método.

Veja também o método `Class.Instance:GetDescendants()|GetDescendants()`.

Instance:GetChildren

Um array contendo os filhos da instância.

Retorna um array contendo todos os filhos da instância.

Instance:getChildren

Retorna uma string codificada do ID de depuração usado internamente pelo Roblox. Observe que:

- Este item é protegido. Tentar usá-lo em um `Class.Script` ou
  `Class.LocalScript` causará um erro.
- Um ID de depuração é um ID usado em processos de depuração. Ele permite que um depurador leia
  cada instrução antes que um aplicativo a processe. Todos os objetos no
  Roblox agem como processos e cada execução de instruções (ou 'código')
pode ser depurada se necessário.
- Isso pode ser útil para plugins que precisam distinguir objetos similares
de um ao outro (como objetos que compartilham o mesmo nome).

Instance:GetDebugId

scopeLength

Retorna uma string codificada do ID de depuração usado internamente pelo Roblox.

GetDescendants é frequentemente usado para fazer algo com todos os descendentes que são de um
tipo específico de objeto. O código neste exemplo usa GetDescendants e
`Class.Instance:IsA()` para encontrar todas as partes no workspace e as torna
verdes.

Este método de objeto retorna um array que contém todos os descendentes
 daquele objeto. Diferente de `Class.Instance:GetChildren()`, que só retorna
 os filhos imediatos de um objeto, este método encontra cada filho do
 objeto, cada filho desses filhos, e assim por diante.

Observe que o array retornado **não** é ordenado em nenhuma ordem particular, então
uma ordenação manual (por exemplo, usando `Library.table.sort()`) é recomendada para
ordenar os descendentes retornados por este método. Também considere o
método `Class.Instance:QueryDescendants()|QueryDescendants()` para consultar
descendentes por uma combinação de seletores e combinadores.

Instance:GetDescendants

Um array contendo os descendentes da instância.

Retorna um array contendo todos os descendentes da instância.

Este exemplo de código demonstra o comportamento de `Class.Instance:GetFullName()`.
Ele mostra como a função se comporta ao ser chamada em um objeto que não está na
hierarquia `DataModel`, e também mostra como o valor de retorno não escapa
caracteres especiais.

Este exemplo de código reimplementa a função `Class.Instance:GetFullName()` em
Lua.

Retorna uma string descrevendo a ancestralidade da instância. A string é uma
concatenação do `Class.Instance.Name|Name` do objeto e seus
ancestrais, separados por pontos. O `Class.DataModel` (`game`) não
é considerado. Por exemplo, um `Class.Part` no `Class.Workspace` pode
retornar `Class.Workspace.Part`.

Quando chamado em uma `Class.Instance` que não é um descendente do
`Class.DataModel`, este método considera todos os ancestrais até e incluindo
o mais alto que não tenha um `Class.Instance.Parent|Parent`.

Este método é útil para registro e depuração. Você não deve tentar
analisar a string retornada para qualquer operação útil; este método não
escapa pontos (ou qualquer outro símbolo) em nomes de objetos. Em outras palavras,
embora sua saída frequentemente pareça ser um identificador Luau válido, não é
garantido.

Instance:GetFullName

Retorna uma string descrevendo a ancestralidade da instância.

Este método retorna o valor estilizado ou explicitamente modificado da
propriedade especificada, ou o valor padrão da propriedade se não tiver sido
estilizado/modificado. Isso difere ligeiramente do acesso ao valor da propriedade
diretamente, como `[GuiObject].Rotation`, que retorna o valor padrão ou
modificado da propriedade.

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

-- Referência a um botão
local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

print(button:GetStyled("Rotation")) --> 0 (valor padrão)
print(button.Rotation) --> 0 (valor padrão)

-- Aplique rotação através da propriedade da regra de estilo
rule:SetProperty("Rotation", 30)

print(button:GetStyled("Rotation")) --> 30 (valor estilizado com base na regra)
print(button.Rotation) --> 0 (valor padrão)

-- Modificar/substituir explicitamente propriedade estilizada
button.Rotation = 45

print(button:GetStyled("Rotation")) --> 45 (valor modificado)
print(button.Rotation) --> 45 (valor modificado)
```

Instance:GetStyled

selector

Selecionador opcional para a pseudo instância que você está mirando na
instância.

O valor estilizado ou explicitamente modificado da propriedade especificada, ou
 o valor padrão da propriedade se não tiver sido estilizado/modificado.

Retorna o valor estilizado ou explicitamente modificado da propriedade especificada,
ou o valor padrão da propriedade se não tiver sido estilizado/modificado.

Este método retorna um evento que se comporta exatamente como o
evento `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`,
exceto que ele só é acionado quando a propriedade de estilo dada muda. É
geralmente uma boa ideia usar este método em vez de uma conexão para
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` com uma
função que verifica o nome da propriedade. Chamadas subsequentes a esse método
no mesmo objeto com o mesmo nome de propriedade retornam o mesmo evento.

Observe que este evento não passará argumentos para uma função conectada,
sendo necessário ler o valor da propriedade alterada diretamente dentro de um
script.

```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("A propriedade de estilo mudou!")
end

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

Instance:GetStyledPropertyChangedSignal

property

Nome da propriedade de estilo para a qual escutar mudanças.

Evento que é acionado quando a propriedade de estilo dada muda.

Este método retorna um array das tags aplicadas à dada instância, como
strings. Você pode adicionar tags tanto no Studio na
[Propriedades](/studio/properties) quanto em tempo de execução com
`Class.Instance:AddTag()|AddTag()`.

Este método é útil quando você deseja fazer algo com várias tags em
uma instância ao mesmo tempo. No entanto, é ineficiente usar este método para
verificar a existência de uma única tag; em vez disso, use
`Class.Instance:HasTag()|HasTag()` para verificar por uma tag específica.

Instance:GetTags

Obtém um array de todas as tags aplicadas à instância.

Este método retorna `true` se a tag fornecida foi adicionada ao
objeto. Você pode adicionar tags tanto no Studio na
[Propriedades](/studio/properties) quanto em tempo de execução com
`Class.Instance:AddTag()|AddTag()`.

Instance:HasTag

Verifica se a instância tem uma tag dada.

Demonstra como determinar se uma instância é o antepassado de outra usando
`Class.Instance:IsAncestorOf()`

Workspace e SpawnLocation são antepassados do decalque de SpawnLocation.
Workspace é um antepassado de SpawnLocation.

SpawnLocation e seu decalque são descendentes do Workspace, não antepassados.
Decalque é um descendente de SpawnLocation, não um antepassado.


Retorna verdadeiro se uma `Class.Instance` é um ancestral do dado
descendente.

Uma `Class.Instance` é considerada o ancestral de um objeto se o
`Class.Instance.Parent` do objeto ou um de seus pais
`Class.Instance.Parent` estiver definido como a `Class.Instance`.

Veja também, `Class.Instance:IsDescendantOf()`.

Instance:IsAncestorOf

Verdadeiro se a `Class.Instance` é um ancestral do dado descendente.

Retorna verdadeiro se uma `Class.Instance` é um ancestral do dado
descendente.

Retorna `true` se uma `Class.Instance` é um descendente do dado
ancestral.

Observe que `IsDescendantOf()` não pode ser usado com um parâmetro `nil` para
verificar se um objeto foi removido.

Veja também `Class.Instance:IsAncestorOf()`.

Instance:IsDescendantOf

ancestor

Verdadeiro se a `Class.Instance` é um descendente do dado ancestral.

Retorna `true` se uma `Class.Instance` é um descendente do dado
ancestral.

Instance:isDescendantOf

Este método indica se uma propriedade específica foi modificada a partir
 do padrão instanciado por código. Se chamado em uma instância recém-criada via
código (`Datatype.Instance.new()`), este método retornará `false`. Se
chamado em um objeto recém-criado por fluxos de trabalho do Studio, como
 a inserção da janela [Explorer](/studio/explorer), o resultado pode
 mudar.

Por exemplo, consultar a
`Class.TextLabel.BackgroundColor3|BackgroundColor3` propriedade de um
`Class.TextLabel` inserido via janela [Explorer](/studio/explorer)
retornará `true`, mas consultar a mesma propriedade de um `Class.TextLabel`
 criada através de `Datatype.Instance.new()` retornará `false`, supondo que não
outras alterações tenham sido feitas ao seu
`Class.TextLabel.BackgroundColor3|BackgroundColor3`.

Observe que este método só retorna resultados úteis para serviços e
instâncias criáveis pelo usuário. Valores de retorno para propriedades populadas por
sistema de instâncias como `Class.PackageLink` têm comportamento indefinido.

Além disso, observe que se este método retornar `true`, a estilização **não** afetará
 a propriedade porque a modificação explícita de uma propriedade tem precedência sobre
 a estilização dela. Para redefinir uma propriedade para seu padrão instanciado por código
e permitir que a estilização a afete, use
`Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()`.

Instance:IsPropertyModified

Booleano indicando se a propriedade é modificada a partir de sua
padrão instanciado por código.

Retorna `true` se o valor armazenado na propriedade especificada não é igual
o padrão instanciado por código.

Este método de objeto retorna uma array que contém todos os descendentes do
objeto que correspondem à string `selector` fornecida. `selector` pode incluir
vários seletores e combinadores para corresponder a características como o
nome da classe, nome da instância e relações hierárquicas, bem como
valores específicos de propriedades e atributos da instância. A gramática do `selector`
ém semelhante à utilizada em `Class.StyleRule`, com apenas algumas
diferenças em relação às partes da gramática que são suportadas ou não.

#### Seletores

- `ClassName` — Correspondência de instâncias da classe especificada em um
  relacionamento `Class.Object:IsA()`.
- `.Tag` — Correspondência de instâncias marcadas com uma tag do `Class.CollectionService`.
- `#Name` — Correspondência de instâncias com um `Class.Instance.Name` específico.
- `[property = value]` — Correspondência de instâncias que têm a propriedade
  especificada e que essa propriedade tenha o valor especificado. Valores booleanos, numéricos e
  de string são suportados. Letras, números, `_` e `-` podem ser utilizados
  sem colocar o valor entre aspas.
- `[$attribute]` — Correspondência de instâncias que têm o
  [atributo](/studio/properties#instance-attributes) especificado definido.
- `[$attribute = value]` — Correspondência de instâncias que têm o atributo
  especificado **e** que esse atributo tenha o valor especificado. As mesmas
  limitações se aplicam aos seletores de propriedades. Se você deseja verificar a
  ausência de um atributo, não o consulte como `nil`; em vez disso, use o
  pseudo‑classe `:not` como em `:not([$attribute])`.

Os seletores também podem ser combinados. Por exemplo,
`Model.Apple[$Variety = Fuji][$Flavor = 4]` corresponderá às instâncias que são
uma `Class.Model` marcada como `Apple` e que têm um atributo `Variety`
equal a `Fuji`, além de um atributo `Flavor` igual a `4`.

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

-- Obter todos os descendentes MeshPart
print(Workspace:QueryDescendants("MeshPart"))

-- Obter todos os descendentes marcados como "Fruit"
print(Workspace:QueryDescendants(".Fruit"))

-- Obter todos os descendentes com o nome "RedTree"
print(Workspace:QueryDescendants("#RedTree"))

-- Obter todos os descendentes com a propriedade CanCollide definida como falsa
print(Workspace:QueryDescendants("[CanCollide = false]"))

-- Obter todos os descendentes com um atributo "FuelCapacity" atribuído
print(Workspace:QueryDescendants("[$FuelCapacity]"))
-- Obter todos os descendentes com um atributo "FuelCapacity" definido como 75
print(Workspace:QueryDescendants("[$FuelCapacity = 75]"))
```

#### Combinadores

Combinadores permitem misturar seletores básicos para corresponder a relações hierárquicas mais profundas.

- `>` — Correspondência de instâncias que são **filhos diretos** das correspondências do filtro anterior.

- `>>` — Correspondência de instâncias que são **descendentes** das correspondências do filtro anterior. Este é o primeiro filtro padrão, o que significa que `SpotLight.Red`
  é o mesmo que `>> SpotLight.Red`.

- `,` — Especifica uma lista de múltiplos seletores independentes para a
  consulta de descendentes. Apenas os elementos que correspondem ao filtro são colocados na
  array retornada; `nil` não será incluido para não-correspondências em uma lista de consulta.

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

-- Obter filhos diretos de qualquer Modelo que sejam marcados como "SwordPart"
print(Workspace:QueryDescendants("Model > .SwordPart"))

-- Obter filhos diretos que são uma Parte e estão marcados como "Apple"
print(Workspace:QueryDescendants("> Part.Apple"))

-- Obter descendentes de qualquer Modelo com um atributo "OnFire" definido como verdadeiro
print(Workspace:QueryDescendants("Model >> [$OnFire = true]"))

-- Obter descendentes MeshPart marcados como "SwordPart" OU com um atributo "OnFire" definido como verdadeiro
print(Workspace:QueryDescendants("MeshPart.SwordPart, MeshPart[$OnFire = true]"))
```

#### Seletores de pseudo-classe

- `:not(complex-selector-list)` — Permite selecionar instâncias que **não** correspondem a nenhum dos seletores dentro, realizando efetivamente uma
  negação dos seletores. Como a expressão interna é uma lista de
  seletores complexos, é possível filtrar com base em múltiplas condições.

- `:has(relative-selector-list)` — Permite selecionar instâncias com base
  nas instâncias que contêm dentro de si. A lista de seletores é avaliada
  em relação a cada instância.

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

-- Obter todos os descendentes que NÃO são da classe SpotLight
print(Workspace:QueryDescendants(":not(SpotLight)"))
-- Obter todos os descendentes que NÃO são da classe SpotLight OU PointLight
print(Workspace:QueryDescendants(":not(SpotLight, PointLight)"))
-- Obter todos os descendentes que NÃO têm um atributo "OnFire"
print(Workspace:QueryDescendants(":not([$OnFire])"))
-- Obter todos os descendentes EXCETO filhos de um Modelo marcado como "SwordPart"
print(Workspace:QueryDescendants(":not(Model > .SwordPart)"))

-- Obter descendentes que contêm uma instância Tool como seu próprio descendente
print(Workspace:QueryDescendants(":has(Tool)"))
-- Obter descendentes MeshPart que contêm um filho direto marcado como "SwordPart"
print(Workspace:QueryDescendants("MeshPart:has(> .SwordPart)"))

-- Obter descendentes MeshPart com filhos diretos NÃO da classe SurfaceAppearance ou Texture
print(Workspace:QueryDescendants("MeshPart:has(> :not(SurfaceAppearance, Texture))"))
```


Instance:QueryDescendants

String de seletor usada para filtrar elementos.

Um array de instâncias (vazio se nada corresponder ao seletor).

Retorna uma array contendo todos os descendentes da instância que correspondem à
string `selector`.


Instance

`Instance` é a classe base para todas as classes na hierarquia de classes do Roblox
que podem fazer parte da árvore `Class.DataModel`.