Um HumanoidController é um objeto interno responsável por traduzir
movimentos de PlayerAction para o personagem do usuário (especificamente, seu
`Class.Humanoid`).

Este objeto pode ser encontrado dentro do `Class.ControllerService`, através de:

```lua
local ControllerService = game:GetService("ControllerService")
local HumanoidController = ControllerService:FindFirstChildOfClass("HumanoidController")
```


HumanoidController

A classe base para objetos de controle, como o objeto `Class.HumanoidController`


Disparado quando o estado pressionado de um botão vinculado é alterado. Este evento pode
ser usado em conjunto com `Class.Controller:GetButton()` para verificar se
um botão vinculado está sendo pressionado ou não.


Controller.ButtonChanged

button

O exemplo abaixo, quando colocado dentro de um `Class.LocalScript`, resultaria em uma
GUI dizendo "Pressione Backspace para ganhar!".

Ativa um bind de sobreposição no botão especificado.


Controller:BindButton

caption

Retorna se o botão está sendo pressionado ou não.


Controller:GetButton

Controller:UnbindButton

Controller:bindButton

Controller:getButton

Controller

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

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


Demonstra a detecção de mudanças na ancestralidade de uma instância conectando-se ao evento `Class.Instance.AncestryChanged`.

O Parent de ChangingPart é definido para valores diferentes ao longo do tempo. O pai da parte é o ancestral da parte, portanto, o evento `Class.Instance.AncestryChanged` será acionado sempre que mudar.

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

Este evento inclui dois parâmetros: `child` refere-se ao `Class.Instance`
cuja `Class.Instance.Parent` foi realmente alterada, enquanto `parent` refere-se
ao novo `Class.Instance.Parent` desta instância.

Você pode usar este evento para rastrear a exclusão de uma instância no Studio,
como exclusão manual no Explorer ou através 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

O `Class.Instance` cuja `Class.Instance.Parent` foi alterada.


parent

O novo `Class.Instance.Parent` do `Class.Instance` cuja
`Class.Instance.Parent` foi alterada.


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


Este evento dispara sempre que qualquer atributo é alterado na instância,
inclusive quando um atributo é definido como `nil`. O nome do atributo 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 da parte mudar:

```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 muda.


Instance.AttributeChanged

attribute

Dispara sempre que um atributo é alterado no `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`.

Note que, ao usar esta função em um cliente para detectar objetos criados pelo
dos servidores, é 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 para replicar 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 replicado ainda
	local head = child:WaitForChild("Head")
end)
```

Note que esta função só funciona para filhos imediatos da
`Class.Instance`. Para uma função 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`.


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

Dispara após uma criança ser removida desta `Class.Instance`.

Removido refere-se quando o pai de um objeto é alterado deste
`Class.Instance` para algo diferente deste `Class.Instance`. Note que este
evento também será disparado quando uma criança for destruída (usando
`Class.Instance:Destroy()`) já que a função destructora define o pai de um
objeto como `nil`.

Esta função só funciona para filhos imediatos da `Class.Instance`.
Para uma função que captura todos os descendentes, use
`Class.Instance.DescendantRemoving`.

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


Instance.ChildRemoved

Dispara após uma criança ser removida desta `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, parentar um objeto à
`Class.Instance` disparará o evento 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** que o pai `Class.Instance`
se altere de forma que um **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 em que este evento disparar. Se o
descendente também for um **filho direto** do pai, este evento disparará
antes de `Class.Instance.ChildRemoved`.

Se um descendente possui filhos, este evento dispara com o descendente primeiro,
seguido de 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 da manipulação do pai, 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 da `Class.Instance` ser removido.


Este exemplo demonstra como, ao usar o comportamento de sinal imediato, uma Instância sendo destruída permanece em seu lugar até que a função conectada ceda.

Este exemplo demonstra como, ao usar o comportamento de sinal diferido,
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
ainda estiver usando-o. No entanto, se a função suspender em algum momento,
o `Class.Instance` e seus descendentes serão parentados a `nil`.

Se a propriedade `Class.Workspace.SignalBehavior` estiver definida como
`Enum.SignalBehavior.Immediate`, este evento dispara imediatamente antes que o
`Class.Instance` ou um de seus antecessores seja 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 retomada,
que ocorrerá após o `Class.Instance` ou um de seus antecessores ser
destruído com `Class.Instance:Destroy()`.

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

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


Instance.Destroying

Dispara imediatamente antes (ou é adiado até depois) que a instância é
destruída via `Class.Instance:Destroy()`.


Este evento dispara sempre que qualquer propriedade de estilo é alterada na instância,
inclusive 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 mudadas")
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`.


Instance.childAdded

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

##### Avisos

- As etiquetas de uma instância que foram adicionadas do lado do cliente serão
  descartadas se o servidor adicionar ou remover uma etiqueta nessa instância
  mais tarde, pois o servidor replica todas as etiquetas juntas e sobrescreve
  etiquetas anteriores.

- Ao etiquetar uma instância, é comum que alguns recursos sejam usados para
  dar à etiqueta sua funcionalidade, por exemplo, conexões de eventos ou tabelas.
  Para evitar vazamentos de memória, é uma boa ideia limpar isso (desconectar,
  definir como `nil`, etc.) quando não for mais necessário para uma etiqueta. Faça isso ao
  chamar `Class.Instance:RemoveTag()`, ao chamar
  `Class.Instance:Destroy()`, ou em uma função conectada a um sinal
  retornado por `Class.CollectionService:GetInstanceRemovedSignal()`.


Instance:AddTag

Esta função 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("Filhos:", #part:GetChildren())  --> Filhos: 3

part:ClearAllChildren()

print("Filhos:", #part:GetChildren())  --> Filhos: 0
```

Se você não deseja destruir **todos** os filhos e descendentes, use
a função `Class.Instance:GetChildren()` ou `Class.Instance:GetDescendants()` para
percorrer esses filhos/descendentes e selecionar o que destruir. Por exemplo,
oh seguinte exemplo de código destruirá todos os
`Class.BasePart|BaseParts` descendo 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

Esta função 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`. Note que se a própria instância tiver
`Class.Instance.Archivable|Archivable` definido como `false`, esta função
retornará `nil`.

Se uma propriedade de referência, como `Class.ObjectValue.Value`, for 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 refere a uma instância que também foi
  clonada, a cópia se referirá à cópia.
- Se uma propriedade de referência se refere 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`.


Demonstra como destruir 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`, trava a
propriedade `Class.Instance.Parent`, desconecta todas as conexões, e chama
`Destroy()` em todos os filhos. Esta função é a maneira correta de descartar
objetos que não são mais necessários.

Descartar objetos desnecessários é importante, pois objetos e
conexões desnecessárias em um lugar consomem memória, o 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 quaisquer
variáveis que referenciem o objeto (ou seus descendentes) como `nil`. Isso
impede que seu código acesse algo relacionado ao objeto.

```lua
local part = Instance.new("Part")
part.Name = "Olá, mundo"
part:Destroy()
-- Não faça isso:
print(part.Name)  --> "Olá, mundo"
-- Faça isso para evitar que a linha acima funcione:
part = nil
```

Uma vez que um `Class.Instance` tenha sido destruído por este método, ele não pode ser
reutilizado porque a propriedade `Class.Instance.Parent` está bloqueada. 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 período definido, use
`Class.Debris:AddItem()`.


Instance:Destroy

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


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

Esta função trabalha para cima, o que significa que começa no `Class.Instance.Parent` imediato
da instância e trabalha até o `Class.DataModel`. Se nenhum
ancestral correspondente for encontrado, retorna `nil`.

O fragmento de código a seguir encontraria o primeiro ancestral do objeto
nomeado `Carro`.

```
local car = object:FindFirstAncestor("Carro")
```

Para variantes desta função 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 dado.


Retorna o primeiro ancestral da `Class.Instance` cuja
`Class.Object.ClassName` é igual ao className dado.

Esta função trabalha para cima, o que significa que começa no `Class.Instance.Parent` imediato
da instância e trabalha até o `Class.DataModel`. Se nenhum
ancestral correspondente for encontrado, retorna `nil`.

Um uso comum desta função é encontrar o `Class.Model` ao qual um
`Class.BasePart` pertence. Por exemplo:

```
local model = part:FindFirstAncestorOfClass("Model")
```

Esta função é 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, utilizando o método `Class.Object:IsA()` em vez disso para respeitar a herança de classes.


Instance:FindFirstAncestorOfClass

className

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


Retorna o primeiro ancestral da `Class.Instance` cuja
`Class.Object.ClassName` é igual ao className dado.


Retorna o primeiro ancestral da `Class.Instance` para quem
`Class.Object:IsA()` retorna verdadeiro para o className dado.

Esta função trabalha para cima, o que significa que começa no `Class.Instance.Parent` imediato
e trabalha até o `Class.DataModel`. Se nenhum
ancestral correspondente for encontrado, retorna `nil`.

Diferentemente de `Class.Instance:FindFirstAncestorOfClass()`, esta função usa
`Class.Object:IsA()` que respeita a herança de classes. 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 className dado.


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 dado, ou
`nil` se não houver tal filho. Se o argumento opcional `recursive` for
`true`, esta função pesquisa em todos os descendentes em vez de apenas nos
filhos imediatos da `Class.Instance`.

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

`FindFirstChild()` é necessário se você precisar 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 espaço de trabalho
Workspace.Part.Transparency = 0.5
```

Uma abordagem melhor é usar `FindFirstChild()` para primeiro verificar se `Part` existe,
então usar uma declaração `if` para executar o código que precisa disso.

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

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

##### Encontrando um Filho Cujo Nome Combina com uma Propriedade

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

No exemplo a seguir, uma `Class.Folder` chamada `Color` é adicionada a um
`Class.Part`, que também possui a propriedade `Class.Part.Color`. Perceba que
`part.Color` refere-se ao valor da propriedade `Datatype.Color3`, e não à instância do filho `Class.Folder`. Um benefício de usar
`Class.Instance:FindFirstChild()|FindFirstChild()` é que a
introdução de novas propriedades não impõe um 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 filho
```

##### Notas de Desempenho

`Class.Instance:FindFirstChild()|FindFirstChild()` leva cerca de 20% mais
do que usar o operador de ponto e quase 8 vezes mais do que simplesmente armazenar
a 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,
estabeleça 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

O `Class.Instance.Name` a ser pesquisado.


recursive

Se a pesquisa deve ser realizada recursivamente ou não.


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


Retorna o primeiro filho da `Class.Instance` cujo
`Class.Object.ClassName|ClassName` é igual ao `className` dado.
Diferentemente de `Class.Instance:FindFirstChildWhichIsA()`, esta função\nretorna apenas objetos cuja classe corresponde a `className`, ignorando a herança de classe. Se nenhum filho correspondente for encontrado, esta função retorna `nil`.


Instance:FindFirstChildOfClass

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


Retorna o primeiro filho da `Class.Instance` para quem
`Class.Object:IsA()` retorna verdadeiro para o className dado.

Se nenhum filho correspondente for encontrado, esta função retorna `nil`. Se o
argumento opcional recursivo for verdadeiro, esta função pesquisa todos
os descendentes em vez de apenas os filhos imediatos da
`Class.Instance`.

Diferentemente de `Class.Instance:FindFirstChildOfClass()`, esta função 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
`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

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


Retorna o primeiro filho da `Class.Instance` para quem
`Class.Object:IsA()` retorna verdadeiro para o className dado.


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

Este método está desativado 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()`.


Instance:FindFirstDescendant

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


Se o `Class.Instance` for um `Class.Actor`, o próprio `Class.Actor` é
retornado. Caso contrário, seu ancestral mais próximo `Class.Actor` é 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 dado
nome do atributo. Se nenhum atributo tiver sido atribuído, `nil` é retornado.

Por exemplo, o seguinte fragmento 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 dado
  nome para o valor dado.
- `Class.Instance:GetAttributes()` que retorna um dicionário de pares chave-valor
  para cada um dos atributos da instância.


Instance:GetAttribute

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


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


Esta função retorna um evento que se comporta exatamente como o
`Class.Object.Changed|Changed` evento, 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 a
`Class.Object.Changed|Changed` com uma função que verifica o nome do atributo. Chamadas subsequentes a 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 aciona 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 mudado")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```

Veja também `Class.Instance.AttributeChanged` que é acionado sempre que qualquer
atributo é mudado 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 dado atributo muda.


Retorna um evento que é acionado quando o dado atributo 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-`nil`.

Por exemplo, o seguinte fragmento 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 dado nome do atributo.


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-nil.


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 for numérico ou genérico:

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

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

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

-- Exemplo de loop for genérico
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " é o filho número " .. i)
end
```

Os filhos são organizados pela ordem em que sua
propriedade `Class.Instance.Parent|Parent` foi definida para o objeto.

Veja também a função `Class.Instance:GetDescendants()|GetDescendants`.


Instance:GetChildren

Um array contendo os filhos da instância.


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


Retorna uma string codificada do ID de depuração usado internamente pelo Roblox. Note
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 atuam como processos e cada execução de instruções (ou 'código') pode ser
debugada se necessário.
- Isso pode ser útil para plugins que precisam distinguir objetos semelhantes 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
desse objeto. Diferentemente de `Class.Instance:GetChildren()`, que somente retorna
os filhos imediatos de um objeto, este método encontra cada filho do
objeto, cada filho desses filhos, e assim por diante.


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

Ao ser chamado em uma `Class.Instance` que não é um descendente do
`Class.DataModel`, esta função considera todos os ancestrais até e
incluindo o mais alto que não possui um `Class.Instance.Parent|Parent`.

Esta função é útil para registro e depuração. Você não deve tentar
analisar a string retornada para qualquer operação útil; esta função não
escapa pontos (ou qualquer outro símbolo) nos nomes dos objetos. Em outras palavras,
embora sua saída frequentemente pareça ser um identificador válido em Luau, isso 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 então o valor padrão da propriedade se não tiver sido
estilizado/modificado. Isso difere ligeiramente do acesso direto ao valor da propriedade,
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)

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

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

-- Modificar/override explicitamente a propriedade estilizada
button.Rotation = 45

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


Instance:GetStyled

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


Retorna o valor estilizado ou explicitamente modificado da propriedade especificada,
ou então 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
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` evento,
exceto que ele só é acionado quando a propriedade de estilo dada muda. É
generalmente uma boa ideia usar este método em vez de uma conexão a
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` com uma
função que verifica o nome da propriedade. Chamadas subsequentes a este método no mesmo objeto com o mesmo
nome de propriedade retornam o mesmo evento.

Note que este evento não passará nenhum argumento para uma função conectada,
portanto, o valor da propriedade alterada deve ser lido 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("Propriedade de estilo mudada!")
end

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


Instance:GetStyledPropertyChangedSignal

property

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


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


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

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


Instance:GetTags

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


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


Instance:HasTag

Verifica se a instância tem uma etiqueta dada.


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

Workspace e SpawnLocation são ancestrais do decalque do SpawnLocation.
Workspace é um ancestral do SpawnLocation.

SpawnLocation e seu decalque são descendentes do Workspace, não ancestrais.
Decalque é um descendente do SpawnLocation, não um ancestral.

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

Um `Class.Instance` é considerado o ancestral de um objeto se o
`Class.Instance.Parent` do objeto ou um dos `Class.Instance.Parent` de seu pai
estiver definido como o `Class.Instance`.

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


Instance:IsAncestorOf

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


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


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

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

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


Instance:IsDescendantOf

ancestor

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


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


Retorna `true` se o valor armazenado na propriedade especificada é igual ao
padrão instanciado por código. Por exemplo, se a saída do
`Class.TextLabel.TextSize|TextSize` de um `Class.TextLabel`
indica `8`, então chamar `IsPropertyModified("TextSize")` no rótulo
retornará `false` porque `8` é o valor padrão para
`Class.TextLabel.TextSize` quando o rótulo é criado via
`Instance.new("TextLabel")` em vez de inserido através dos fluxos de trabalho de inserção do Studio.

Note que se este método retornar `true`, a estilização **não** afetará a
propriedade porque modificar explicitamente uma propriedade tem precedência sobre
estilizar.


Instance:IsPropertyModified

Booleano indicando se a propriedade foi modificada.


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


O seguinte código demonstra como uma parte pode ser adicionada novamente ao DataModel
após ser removida:

Esta função define o `Class.Instance.Parent` do objeto como `nil`, e faz
o mesmo para todos os seus descendentes.

Se o objeto for referenciado antes de ser removido, é possível
recuperar o objeto posteriormente.


Instance:Remove

Define o `Parent` do objeto como `nil`, e faz o mesmo para todos os seus
descendentes.


Este método remove uma etiqueta de uma instância. Ele não gerará um erro se
o objeto não tiver a etiqueta. Remover uma etiqueta com sucesso acionará um
sinal criado por `Class.CollectionService:GetInstanceRemovedSignal()`
com a etiqueta fornecida.

Note que ao etiquetar uma instância, é comum que alguns recursos sejam
usados para dar à etiqueta sua funcionalidade, por exemplo, conexões de eventos ou
tabelas. Para evitar vazamentos de memória, é uma boa ideia limpar isso
(desconectar, definir como `nil`, etc.) quando não for mais necessário para uma etiqueta.


Instance:RemoveTag

Redefine uma propriedade para seu valor padrão. Por exemplo, chamar
`ResetPropertyToDefault("Rotation")` em um `Class.TextLabel` é equivalente
a definir sua `Class.TextLabel.Rotation|Rotation` para `0` (o valor padrão da propriedade). Este método pode ser usado para garantir que a estilização substitua
este valor padrão da propriedade.


Instance:ResetPropertyToDefault

Redefine uma propriedade para seu valor padrão.


Este método define o atributo com o dado nome para o dado valor. Se o valor
for `nil`, o atributo será removido, uma vez que `nil` é
retornado por padrão.

Por exemplo, o seguinte fragmento de código define o atributo
`InitialPosition` da instância para `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))
```

##### Limitações

Requisitos e restrições de nome:

- Os nomes devem usar apenas caracteres alfanuméricos e sublinhado.
- Nenhos espaços ou símbolos únicos são permitidos.
- Strings devem ter 100 caracteres ou menos.
- Nomes não podem começar com **RBX** a menos que o chamador seja um
  script de núcleo do Roblox (reservado para o Roblox).

Ao tentar definir um atributo para um tipo não suportado, um erro será
gerado.

##### Veja Também

- `Class.Instance:GetAttribute()` que retorna o valor que foi
  atribuído ao dado nome do atributo.
- `Class.Instance:GetAttributes()` que retorna um dicionário de pares chave-valor
  para cada um dos atributos da instância.


Instance:SetAttribute

value

O valor a ser definido para o atributo especificado.


Define o atributo com o dado nome para o dado valor.


O código a seguir aguarda que uma instância chamada "Part" seja adicionada ao
Espaço de Trabalho.

Retorna o filho da `Class.Instance` com o dado nome. Se o
filho não existir, ele suspenderá o thread atual até que exista. Se
o parâmetro `timeOut` for especificado, este método excederá o timeout após o
número especificado de segundos e retornará `nil`.

##### Uso Principal

`Class.Instance:WaitForChild()|WaitForChild()` é extremamente importante ao
trabalhar em código executado pelo cliente em um `Class.LocalScript`. O motor Roblox
não garante o tempo ou a ordem em que objetos são
replicados do servidor para o cliente. Além disso, se uma experiência
possui `Class.Workspace.StreamingEnabled` definida como verdadeira,
`Class.BasePart|BaseParts` que estão longe do personagem do jogador
podem não ser transmitidos para o cliente, possivelmente causando que scripts quebrem
quando indexam objetos que ainda não existem no cliente.

##### Notas

- Esta função não suspenderá se um filho com o dado nome existir quando
  a chamada for feita.
- `Class.Instance:FindFirstChild()` é uma alternativa mais eficiente para
  `Class.Instance:WaitForChild()|WaitForChild()` para objetos que se
  presume que existam.
- Se uma chamada a este método exceder 5 segundos sem retornar, e nenhum
  parâmetro `timeOut` tiver sido especificado, um aviso será impresso na
  saída de que o thread pode renderizar indefinidamente.


Instance:WaitForChild

childName

timeOut

Um parâmetro de tempo de espera opcional.


Retorna o filho da `Class.Instance` com o dado nome. Se o
filho não existir, ele suspenderá o thread atual até que exista.


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


Instance:children

Instance:clone

Instance:destroy

Instance:findFirstChild

Instance:getChildren

Instance:isDescendantOf

Instance:remove

Instance

Esta propriedade determina se a instância deve ser incluída quando a
experiência é publicada ou salva, ou quando `Class.Instance:Clone()|Clone()`
é chamada em um dos ancestrais da instância. Chamando
`Class.Instance:Clone()|Clone()` diretamente em uma instância retornará `nil`
se essa instância **não** for `Class.Instance.Archivable|Archivable`.

Copiar um objeto no Studio usando as opções **Duplicar** ou **Copiar**/**Colar**
ignorará sua própria propriedade `Class.Instance.Archivable|Archivable`
e definirá `Class.Instance.Archivable|Archivable` para `true` para a
cópia.

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


Instance.Archivable

Determina se um `Class.Instance` e seus descendentes podem ser clonados usando
`Class.Instance:Clone()`, e podem ser salvos/publicados.


O conjunto de capacidades permitidas para serem usadas em scripts dentro desta
instância. Para que as capacidades tenham efeito, a propriedade `Class.Instance.Sandboxed`
deve estar ativada.

Esta propriedade é utilizada por uma funcionalidade experimental. Veja
[capacidades de script](/scripting/capabilities) para mais
detalhes.


Instance.Capabilities

O conjunto de capacidades permitidas para serem usadas em scripts dentro deste
container.


Um identificador não único da `Class.Instance`. Os nomes são usados para manter
a hierarquia de objetos organizada, além de permitir que scripts acessem
objetos específicos. O nome de uma instância não pode exceder 100 caracteres em
tamanho.

O nome de um objeto é frequentemente usado para acessar o objeto através da hierarquia do modelo de dados
usando os seguintes métodos:

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

local baseplate = Workspace.Baseplate
local baseplate = Workspace["Baseplate"]
local baseplate = Workspace:FindFirstChild("BasePlate")
```

Para tornar um objeto acessível usando o operador de ponto (`.`), seu
nome deve começar com um sublinhado ou letra, e o restante do nome pode
conter apenas letras, números ou sublinhados (sem outros caracteres
especiais). Se o nome de um objeto não seguir essa sintaxe, ele não
será acessível usando o operador de ponto e Luau não interpretará seu nome
como um identificador.

Se houver mais de um objeto com o mesmo nome são irmãos, qualquer tentativa de
indexar um objeto por esse nome retornará apenas um dos objetos, semelhante
a `Class.Instance:FindFirstChild()`, mas nem sempre o objeto desejado.
Se um objeto específico precisar ser acessado através do código, é recomendado
dar a ele um nome único ou garantir que nenhum de seus irmãos compartilhe o
mesmo nome.

Veja também `Class.Instance:GetFullName()` para obter um nome completo incluindo
a hierarquia do objeto.


Instance.Name

Um identificador não único da `Class.Instance`.


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


/reference/engine/classes/HumanoidController.yaml

HumanoidController

Resumo

Propriedades

Métodos

Métodos

Eventos

Eventos

Propriedades

Métodos

Eventos

Nesta página