O objeto Dialog permite aos usuários criar personagens não jogáveis (NPCs) que
os jogadores podem falar usando uma lista de opções. O objeto Dialog pode ser inserido
em uma parte, como a cabeça de um Humanoid, e então um jogador verá uma fala
acima da parte que pode clicar para iniciar uma conversa. O
criador de um lugar pode escolher quais opções o jogador pode dizer inserindo
objetos `Class.DialogChoice` no diálogo.

Disparado quando um jogador escolhe algo para dizer, através de uma instância
`Class.Dialog`.

Este evento é apenas do lado do cliente e não será disparado no servidor. Deve
ser conectado em um `Class.LocalScript` ou em um `Class.ModuleScript`
requerido por um `Class.LocalScript`.

Dialog.DialogChoiceSelected

player

dialogChoice

A `Class.DialogChoice` que foi selecionada pelo jogador.


Disparado quando um jogador escolhe algo para dizer, através de uma instância
`Class.Dialog`.

A função GetCurrentPlayers de um diálogo retornará uma lista de
`Class.Player` que estão usando o diálogo. Se não houver jogadores usando
o diálogo, a lista retornada estará vazia.

Dialog:GetCurrentPlayers

Uma lista de objetos `Class.Player` atualmente envolvidos no Dialog.


Retorna uma lista de jogadores que estão usando o diálogo atualmente.

Dialog

O BehaviorType de um Dialog determina se múltiplos jogadores podem
interagir com um diálogo ao mesmo tempo. O valor padrão para esta propriedade é
SinglePlayer.

#### SinglePlayer

Quando um Dialog é configurado para SinglePlayer, apenas um jogador pode interagir
com ele por vez. Assim que um jogador se envolve com um diálogo, outros
jogadores não poderão iniciar o diálogo até que o primeiro jogador tenha
terminado.

Enquanto um jogador está envolvido com um diálogo, os outros jogadores verão as
escolhas do diálogo do jogador que iniciou o diálogo, junto com as
respostas.

#### MultiplePlayers

Quando um Dialog é configurado para MultiplePlayers, qualquer jogador pode iniciar um diálogo
a qualquer momento, mesmo que outro jogador já tenha iniciado o diálogo.
Diferente de SinglePlayer, no entanto, Dialogs configurados para MultiplePlayers não mostrarão
as escolhas e respostas do diálogo para ninguém além do jogador na
conversa.

Dialog.BehaviorType

Define se o diálogo pode ser usado por múltiplos jogadores ao mesmo tempo.

A distância máxima em studs entre o personagem do jogador e o
pai do Dialog `Class.BasePart` na qual o jogador pode clicar na
bolha de fala para iniciar ou continuar uma conversa. Se o jogador se mover
mais longe do que essa distância em relação à parte pai, ele não pode iniciar o
dialogo. O motor usa esse valor para selecionar o Dialog disponível mais próximo
quando múltiplos estão ao alcance.

O padrão é 25.


Dialog.ConversationDistance

A distância máxima que um jogador pode estar do pai do diálogo para
iniciar uma conversa.

Alterna se a opção de despedida será exibida. Se for verdadeiro, o diálogo
exibirá o conteúdo de `Class.Dialog.GoodbyeDialog` como a última
opção após outras opções de diálogo. Clicar na opção de despedida sairá
do diálogo.

Dialog.GoodbyeChoiceActive

Alterna se a opção de despedida será exibida.

O texto exibido como a opção de despedida na parte inferior da lista de
escolhas do dialogo. Quando `Class.Dialog.GoodbyeChoiceActive` é verdadeiro, essa string
aparece como a última escolha selecionável; clicar nela encerra a conversa.
Quando `Class.Dialog.GoodbyeChoiceActive` é falso, esta propriedade não tem
efeito visível.

O padrão é uma string vazia.


Dialog.GoodbyeDialog

Define a frase que o diálogo mostrará ao jogador quando o chat
terminar.

O texto que o NPC exibe dentro da bolha de fala quando um jogador
começa a conversa. Esta é a linha de abertura que aparece
antes que o jogador selecione entre as opções `Class.DialogChoice` aninhadas sob
este Dialog.

O padrão é uma string vazia.


Dialog.InitialPrompt

Define a primeira frase que o diálogo mostrará ao jogador, uma vez que um
chat tiver sido iniciado.

Um indicador de tempo de execução somente leitura que é verdadeiro sempre que pelo menos um jogador está
atualmente envolvido nesta conversa de dialogo. O motor define isso como
verdadeiro quando um jogador começa a falar e redefine como falso quando todos
os participantes saem. Esta propriedade não é serializada e sempre começa como
falsa quando o lugar é carregado. Scripts podem ler esta propriedade, mas não podem defini-la
diretamente.

O padrão é falso.


Dialog.InUse

Se verdadeiro, este diálogo está sendo utilizado por pelo menos um jogador.

Controla qual ícone aparece no indicador da bolha de fala do dialogo.
Aceita um valor do enum `Enum.DialogPurpose`:

- **Quest** -- exibe um ponto de exclamação (!)
- **Help** -- exibe um ponto de interrogação (?)
- **Shop** -- exibe um sinal de dólar ($)

O padrão é Help.


Dialog.Purpose

Define o ícone que o diálogo inicial exibe.

Controla a cor de destaque na bolha de fala do dialogo. Aceita um valor
do enum `Enum.DialogTone`:

- **Neutral** -- barra de destaque azul
- **Friendly** -- barra de destaque verde
- **Enemy** -- barra de destaque vermelha

O padrão é Neutral.


Dialog.Tone

A distância máxima em studs do pai do Dialog `Class.BasePart` na
qual o indicador de gatilho do dialogo se torna visível para um jogador. Quando o
personagem de um jogador está dentro dessa distância, o ícone da bolha de fala aparece
sobre a parte pai, convidando à interação. O valor é limitado entre 0
e 400.

O padrão é 0, o que efetivamente desabilita o indicador de gatilho baseado na distância;
o jogador deve estar dentro de `Class.Dialog.ConversationDistance`
para ver e interagir com o dialogo.


Dialog.TriggerDistance

Define a distância máxima que um diálogo pode ser acionado.

Um deslocamento `Datatype.Vector3` em studs que muda a posição do
indicador da bolha de fala do dialogo em relação ao pai do Dialog
`Class.BasePart`. Use isso para posicionar o indicador acima ou ao lado do
NPC em vez de no centro da parte. Esta propriedade participa da
escalonamento do modelo.

O padrão é (0, 0, 0).


Dialog.TriggerOffset

Define o deslocamento do diálogo em relação ao pai do diálogo.

Cria bolhas de diálogo estilo placa para NPCs.

`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 objetos `Instance` raiz diretamente, mas o construtor especial
`Datatype.Instance.new()` cria objetos via código, recebendo o
nome da classe como 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,
such as 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

A instância cuja propriedade `Class.Instance.Parent|Parent` mudou,
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 de 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 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 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 dado muda.


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 Espaço de Trabalho:


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

Note 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 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 este evento opera apenas para filhos imediatos da
`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 desta `Class.Instance`.

Removido refere-se a quando o pai de um objeto é alterado de esta
`Class.Instance` para algo diferente desta `Class.Instance`. Note que este
evento também será disparado 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 da `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 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** da
`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`
mude de forma que uma instância **descendente** não será mais um
descendente. `Class.Instance:Destroy()|Destroy()` muda 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 não será alterado 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 tiver filhos, este evento disparará com o descendente primeiro,
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 PORQUE o pai foi manipulado, e a mudança ainda não aconteceu
	-- Portanto, é problemático mudar 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 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á deletado da memória enquanto uma função conectada
estiver ainda usando-o. No entanto, se a função suspender em algum ponto,
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 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 retoma,
que será após o `Class.Instance` ou um de seus ancestrais ser destruído com
`Class.Instance:Destroy()`.

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

Ao deletar 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`
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()`.


Demonstra `Class.Instance.StyledPropertiesChanged`.


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


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

#### Avisos

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

- Ao marcar uma instância, é comum que alguns recursos sejam usados para
dar à tag sua funcionalidade, por exemplo, conexões de eventos ou tabelas.
  Para evitar vazamentos de memória, é uma boa ideia limpar esses recursos
  (desconectar, definir como `nil`, etc.) quando 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("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
`Class.Instance:GetChildren()` ou `Class.Instance:GetDescendants()` para
percorrer esses filhos/descendentes e selecionar o que destruir. 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`. Note 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`, 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 referir a uma instância que foi **também** 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

Uma cópia da instância, ou `nil` se a instância não for
`Class.Instance.Archivable|Archivable`.


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`, bloqueia 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, 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 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 = "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` foi destruído por este método, 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 determinado período de tempo, use
`Class.Debris:AddItem()`.


Instance:Destroy

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


Instance:destroy

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

Este método funciona para cima, ou seja, começa no `Class.Instance.Parent`
imediato da instância e trabalha 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

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


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


Retorna o primeiro ancestral do `Class.Instance` cujo
`Class.Object.ClassName` é igual ao className dado.

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

Um uso comum deste método é encontrar o `Class.Model` ao qual 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 do `Class.Instance` cujo
`Class.Object.ClassName` é igual ao className dado.


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

Este método funciona para cima, ou seja, começa no `Class.Instance.Parent`
imediato da instância e trabalha 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 do `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 do `Class.Instance` com o nome dado, ou
`nil` se nenhum filho desse tipo existir. Se o argumento opcional `recursive` for
`true`, este método pesquisa todos os descendentes em vez de apenas os
filhos imediatos do `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
lança um erro se o filho não existir.

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

-- A linha a seguir gera 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 por `Part`,
depois usar uma declaraçã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
propriedade de seu `Class.Instance.Parent|Parent`. Ao usar o operador de ponto,
as propriedades têm precedência sobre os 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`. Note que
`part.Color` se refere ao valor da propriedade `Datatype.Color3`, não à instância
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
tempo do que usar o operador de ponto e quase 8 vezes mais do que simplesmente 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,
estou 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.


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


Instance:findFirstChild

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


Instance:FindFirstChildOfClass

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


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

Se nenhum filho correspondente for encontrado, este método retorna `nil`. Se o argumento
opcional recursivo for verdadeiro, este método pesquisa todos os descendentes em vez
de apenas os filhos imediatos do `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

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


Retorna o primeiro filho do `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()` em vez disso.


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 nome do
atributo dado. 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 dado
  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 nome do atributo dado. Se nenhum
atributo foi atribuído, `nil` é retornado.


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


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 dado muda; efetivamente é semelhante 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 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 atributo dado muda.


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


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 .. " é o 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 .. " é o filho número " .. i)
end
```
Note que o array retornado **não** é ordenado em nenhuma ordem particular, então
uma ordenação manual (por exemplo, usando `Library.table.sort()`) é aconselhada 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. 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 em
  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 semelhantes
  uns dos outros (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. 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.

Note que o array retornado **não** é ordenado em nenhuma ordem particular, então
uma ordenação manual (por exemplo, usando `Library.table.sort()`) é aconselhada 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 um `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 tem 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) nos nomes dos 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 então o valor padrão da propriedade se não tiver sido
estilizado/modificado. Isso difere ligeiramente de acessar o valor da propriedade
diretamente, como `[GuiObject].Rotation`, que retorna o valor padrão ou
modificado da propriedade.


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


Demonstra `Class.Instance:GetStyledPropertyChangedSignal()`.


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


Instance:GetStyledPropertyChangedSignal

property

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


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


Retorna um evento que é acionado quando a propriedade de estilo dada muda na
instância.


Este método retorna um array das tags aplicadas à instância dada, como
strings. Você pode adicionar tags tanto no Studio na
janela [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 de uma só vez. 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 uma tag específica.


Instance:GetTags

Um array de strings, cada uma representando uma tag aplicada à instância.


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
janela [Propriedades](/studio/properties) quanto em tempo de execução com
`Class.Instance:AddTag()|AddTag()`.


Instance:HasTag

`true` se a instância possui a tag dada, `false` caso contrário.


Verifica se a instância possui uma tag 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 de seus pais
`Class.Instance.Parent` estiver definido para 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 `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.


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
inserção na janela [Explorer](/studio/explorer), o resultado pode
variar.

Por exemplo, consultar a
propriedade `Class.TextLabel.BackgroundColor3|BackgroundColor3` de um
`Class.TextLabel` inserido via a janela [Explorer](/studio/explorer)
retornará `true`, mas consultar a mesma propriedade de um `Class.TextLabel`
criado através de `Datatype.Instance.new()` retornará `false`, assumindo que nenhuma
outra alteração foi feita em seu
`Class.TextLabel.BackgroundColor3|BackgroundColor3`.

Note 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` é comportamento indefinido.

Além disso, 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. Para redefinir uma propriedade ao seu padrão instanciado por código e permitir
estilização nela, use
`Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()`.


Instance:IsPropertyModified

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


Instance

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