O contêiner `PlayerGui` armazena objetos que criam a GUI do jogador. Se um
`Class.ScreenGui` for um descendente de `PlayerGui`, qualquer `Class.GuiObject` dentro
desse `Class.ScreenGui` será exibido na tela do jogador. Qualquer
`Class.LocalScript` também será executado se for inserido em um `PlayerGui`.

Quando um jogador entra pela primeira vez na experiência, seu `PlayerGui` é
automaticamente inserido em seu objeto `Class.Player`. Quando o
`Class.Player.Character` do jogador aparece pela primeira vez, todo o conteúdo de
`Class.StarterGui` é automaticamente copiado para o `PlayerGui` do jogador. Se
`Class.StarterGui.ResetPlayerGuiOnSpawn` estiver definido como `true`, todo o conteúdo de
um `PlayerGui` de jogador é limpo e substituído pelo conteúdo de
`Class.StarterGui` toda vez que o personagem do jogador renasce.

Observe que se `Class.Players.CharacterAutoLoads` estiver definido como `false`, o
personagem não aparecerá e o conteúdo de `Class.StarterGui` não será copiado até
que `Class.Player:LoadCharacterAsync()` seja chamado.

Se você precisar controlar o contêiner de UI de um jogador durante o tempo de jogo, por exemplo, para
mostrar/ocultar um `Class.ScreenGui` específico ou qualquer um de seus filhos, acesse-o da seguinte forma a partir de um `Class.LocalScript`:

O exemplo abaixo imprime o valor da transparência da barra superior quando ela
muda.


Dispara sempre que a transparência da barra superior `Class.CoreGui` muda,
such as após uma chamada para `Class.PlayerGui:SetTopbarTransparency()`. O
evento passa a nova transparência como seu argumento `transparency`, um valor
na faixa `[0, 1]`. Ele só dispara quando a transparência limitada difere
 do valor anterior, então definir o mesmo valor novamente não o faz disparar.


PlayerGui.TopbarTransparencyChangedSignal

transparency

A nova transparência da barra superior após a mudança, um número entre 0
(completamente opaco) e 1 (completamente transparente).


Dispara quando a transparência do CoreGui da barra superior muda.

A linha de código a seguir imprime a transparência da barra superior.


Retorna a transparência atual da barra superior `Class.CoreGui`, um valor na
faixa `[0, 1]` onde `0` é completamente opaco e `1` é completamente
transparente. Este é o valor anteriormente atribuído com
`Class.PlayerGui:SetTopbarTransparency()`, e o padrão é `0.5`. Este
método só pode ser chamado de um `Class.LocalScript`; chamá-lo de um
script de servidor gera um erro.


PlayerGui:GetTopbarTransparency

A transparência atual da barra superior, um número entre 0 (completamente
opaco) e 1 (completamente transparente).


Retorna a transparência da barra superior.

A linha de código a seguir faz com que a Topbar apareça totalmente opaca.


Este exemplo de código demonstra como você pode criar uma topbar com estilo personalizado. Cole
isso em um `Class.LocalScript` colocado dentro de `Class.StarterPlayerScripts`.


Este método define a transparência da barra superior `Class.CoreGui`. Um valor
de `0` é completamente opaco e um valor de `1` é completamente transparente.
Valores fora da faixa `[0, 1]` são limitados. A transparência padrão
da barra superior é `0.5`.

Usar o método `Class.StarterGui:SetCore()` com a opção `"TopbarEnabled"`
permite que você ative/desative toda a barra superior e todos os seus
recursos (lista de jogadores, saúde, etc). Por outro lado, este método afeta apenas
como a barra superior é exibida.

PlayerGui:SetTopbarTransparency

Um número entre 0 (completamente opaco) e 1 (completamente transparente).
Valores fora dessa faixa são limitados.


Define a transparência da barra superior.

PlayerGui

Descreve a orientação atual da tela do jogador como um
`Enum.ScreenOrientation`. Ao contrário da propriedade gravável
`Class.PlayerGui.ScreenOrientation`, que solicita um modo de
orientação _preferido_, `Class.PlayerGui.CurrentScreenOrientation` é somente leitura
e relata a orientação que o dispositivo está realmente exibindo, atualizando conforme
o jogador gira fisicamente um dispositivo móvel.


PlayerGui.CurrentScreenOrientation

Descreve a orientação de tela atual do jogador.

Define o modo de orientação de tela preferido para este jogador quando em um
dispositivo móvel, expresso como um valor `Enum.ScreenOrientation`. Alterá-lo
solicita que o dispositivo trave ou siga uma orientação particular (por
exemplo `Enum.ScreenOrientation|Portrait` ou
`Enum.ScreenOrientation|LandscapeSensor`). A orientação que o dispositivo está
realmente exibindo é relatada separadamente pela propriedade somente leitura
`Class.PlayerGui.CurrentScreenOrientation`. Esta propriedade
defaults para `Enum.ScreenOrientation|LandscapeSensor`.


PlayerGui.ScreenOrientation

Define o modo de orientação de tela preferido para este jogador, se estiver em um
devices móveis.

Substitui o adorno de seleção padrão usado para gamepads. Para melhores
resultados, isso deve apontar para um `Class.GuiObject`.

PlayerGui.SelectionImageObject

Substitui o adorno de seleção padrão usado para gamepads.

Um contêiner que armazena a interface do usuário de um jogador.

`BasePlayerGui` é uma classe abstrata da qual todas as classes de armazenamento de desenho
 da GUI herdam.

Todos os GUIs retornados por `Class.BasePlayerGui:GetGuiObjectsAtPosition()` são
'clonados' pela função local `highlightAsFrame()`, que cria um `Frame`
GUI posicionado em cima do GUI especificado que é semi-transparente e tem o
mesmo `Class.GuiBase2d.AbsoluteSize` e `Class.GuiBase2d.AbsolutePosition`.

Esses destaques são adicionados ao `ScreenGui` HighlightsContainer na
pasta Highlight da pasta PlayerGui do jogador. Ambos são criados pelo
exemplo de código. Todos os GUIs de destaque são `Class.Instance:Destroy()`ados toda vez
que `highlightGui()` é executado.

Observe que a `Class.ScreenGui.DisplayOrder` do HighlightContainer é 99999, um
número grande, para que seja improvável que qualquer outro GUI seja renderizado em cima dos
GUIs de destaque.


Recebe uma posição na tela e retorna uma lista de todas as instâncias de `Class.GuiObject`
 que estão ocupando essa posição na tela, ordenadas na ordem em que aparecem na tela de cima para baixo como o primeiro e último índice,
 respectivamente. O caso de uso principal é obter objetos da GUI sob os inputs de mouse ou toque do jogador para permitir a seleção ou destaque.

Como as classes filhas de `Class.BasePlayerGui` herdaram esta função, ela
 pode ser acionada por classes container como `Class.PlayerGui` e
 `Class.StarterGui`.

BasePlayerGui:GetGuiObjectsAtPosition

A posição **X** na tela relativa ao canto superior esquerdo após
 a inserção da GUI ser aplicada (veja `Class.GuiService:GetGuiInset()`).

A posição **Y** na tela relativa ao canto superior esquerdo após
 a inserção da GUI ser aplicada (veja `Class.GuiService:GetGuiInset()`).

Uma tabela das instâncias de `Class.GuiObject` que ocupam o
espaço na tela especificado.

Retorna uma lista de todas as instâncias de `Class.GuiObject` ocupando o dado


BasePlayerGui

`BasePlayerGui` é uma classe abstrata da qual as classes de armazenamento de desenho
 da GUI herdam.

`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

Booleano indicando se a propriedade foi modificada a partir de seu
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 um array que contém todos os descendentes do
objeto que correspondem à string `selector` fornecida. `selector` pode incluir
múltiplos seletores e combinadores para corresponder a características como o
nome da classe, nome da instância e relacionamentos hierárquicos, bem como
valores específicos de propriedades e atributos da instância. A gramática do `selector`
essemelha à usada em `Class.StyleRule`, com apenas algumas
diferenças em relação a quais partes da gramática são suportadas ou não.

#### Seletores

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

Seletores também podem ser combinados. Por exemplo,
`Model.Apple[$Variety = Fuji][$Flavor = 4]` corresponderá a instâncias que são
um `Class.Model` marcado como `Apple` e que têm um atributo `Variety`
equal a `Fuji`, bem como 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 que você misture seletores básicos para corresponder a relacionamentos hierárquicos mais profundos.

- `>` — Corresponde a instâncias que são **filhos diretos** dos matches do filtro anterior.

- `>>` — Corresponde a instâncias que são **descendentes** dos matches 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 elementos que correspondem ao filtro são colocados no
  array retornado; `nil` não será incluído para não-matches 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 sejam uma Parte e sejam 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, efetivamente realizando 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 em
  quais instâncias elas contêm dentro. 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

Retorna um array contendo todos os descendentes da instância que correspondem ao
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`.
