`Class.StarterGui` é um objeto contêiner projetado para armazenar
objetos `Class.LayerCollector`, como `Class.ScreenGui|ScreenGuis`.

Quando um `Class.Player.Character` aparece, o conteúdo de seu
`Class.PlayerGui` (se houver) é esvaziado. Os filhos do `Class.StarterGui` são
então copiados junto com seus descendentes para o `Class.PlayerGui`. Observe,
todavia, que objetos `Class.LayerCollector` como
`Class.ScreenGui|ScreenGuis` com sua
`Class.LayerCollector.ResetOnSpawn|ResetOnSpawn` propriedade definida como `false`
serão colocados no `Class.PlayerGui` de cada jogador uma única vez e não serão
excluídos quando o `Class.Player` reaparecer.

`Class.StarterGui` também inclui uma variedade de funções que permitem
interagir com o `Class.CoreGui`. Por exemplo, `Class.StarterGui:SetCoreGuiEnabled()`
pode ser usado para desabilitar elementos do `Class.CoreGui`, e
`Class.StarterGui:SetCore()` pode realizar uma gama de funções, incluindo
criar notificações e mensagens de sistema.

Este método retorna dados definidos ou disponibilizados pelos scripts principais do
Roblox. O primeiro e único parâmetro é uma string que seleciona as informações a
serem buscadas. As seções seguintes descrevem as strings e os dados que elas
retornam por esta função.

Chamar este método pode resultar em yield. Muitos deles também registram uma
função equivalente `Class.StarterGui:SetCore()|SetCore()` (estas estão marcadas com um
asterisco).

##### PointsNotificationsActive \\*

Retorna `true` se as notificações de pontos do jogador estão habilitadas.

##### BadgesNotificationsActive \\*

Retorna `true` se as notificações de crachás estão habilitadas.

##### AvatarContextMenuEnabled \\*

Retorna `true` se o
[Menu de Contexto do Avatar](/players/avatar-context-menu) está habilitado.

##### ChatActive \\*

Retorna se o chat está ativo ou não. Isso é indicado pelo
estado de seleção do ícone de chat da barra superior.

##### ChatWindowSize \\*

Retorna o tamanho da janela de chat como `Datatype.UDim2`.

##### ChatWindowPosition \\*

Retorna o tamanho da janela de chat como `Datatype.UDim2`.

##### ChatBarDisabled \\*

Retorna `true` se a barra de chat está desabilitada.

##### GetBlockedUserIds

Retorna uma lista de `Class.Player.UserId|UserIds` associadas a usuários que
foram bloqueados pelo jogador local.

##### PlayerBlockedEvent

Retorna um `Class.BindableEvent` que é acionado sempre que um jogador é bloqueado
pelo jogador local.

##### PlayerUnblockedEvent

Retorna um `Class.BindableEvent` que é acionado sempre que um jogador é
desbloqueado pelo jogador local.

##### PlayerMutedEvent

Retorna um `Class.BindableEvent` que é acionado sempre que um jogador é silenciado
pelo jogador local.

##### PlayerUnmutedEvent

Retorna um `Class.BindableEvent` que é acionado sempre que um jogador é
reabilitado pelo jogador local.

##### PlayerFriendedEvent

Retorna um `Class.BindableEvent` que é acionado sempre que um jogador é
conectado pelo jogador local.

##### PlayerUnfriendedEvent

Retorna um `Class.BindableEvent` que é acionado sempre que um jogador é
desconectado pelo jogador local.

##### DevConsoleVisible \\*

Retorna `true` se o
[Console do Desenvolvedor](/studio/developer-console) está visível.

##### VRRotationIntensity

Retorna uma string descrevendo a sensibilidade de rotação da câmera em VR: `Low`,
`High` e `Smooth`. Isso não estará disponível, a menos que
`Class.VRService.VREnabled` seja `true`.

StarterGui:GetCore

parameterName

Retorna uma variável que foi especificada por um script central do Roblox.

O exemplo abaixo imprimirá se a lista de jogadores está visível para o
LocalPlayer.

Esta função retorna se o dado `Enum.CoreGuiType` está habilitado, ou
se foi desabilitado usando `Class.StarterGui:SetCoreGuiEnabled()`. Esta
função deve ser chamada no cliente.

Observe que definir `"TopbarEnabled"` como `false` usando
`Class.StarterGui:SetCore()|SetCore()` oculta todos
`Enum.CoreGuiType|CoreGuiTypes`, mas não afeta o resultado desta
função.

StarterGui:GetCoreGuiEnabled

coreGuiType

Se o dado `Enum.CoreGuiType` está habilitado.

Retorna se o dado `Enum.CoreGuiType` está habilitado, ou se foi
desabilitado usando `Class.StarterGui:SetCoreGuiEnabled()`.

Este método (não deve ser confundido com
`Class.StarterGui:SetCoreGuiEnabled()|SetCoreGuiEnabled()`) expõe uma
variedade de funcionalidades definidas pelos scripts principais do Roblox, como o envio
de notificações, alterando notificações para emblemas/pontos, definindo um
callback para o botão de reset ou alternando a barra superior.

O primeiro parâmetro é uma string que seleciona a funcionalidade com a qual
a chamada irá interagir. Pode ser necessário chamar este método várias
times usando `Global.LuaGlobals.pcall()` caso o respectivo script principal
não tenha sido carregado (ou se tiver sido desativado completamente).

A tabela a seguir descreve as strings que podem ser aceitas como o
primeiro parâmetro. Os parâmetros que devem seguir dependem da
funcionalidade que será utilizada e estão descritos em subtabelas.

##### ChatActive

Controla se o chat está ativo.

<table size="small">
	<thead>
		<tr>
			<th>Nome</th>
			<th>Tipo</th>
			<th>Padrão</th>
			<th>Descrição</th>
    </tr>
	</thead>
  <tbody>
	<tr>
    <td><code>active</code></td>
    <td>boolean</td>
    <td>(obrigatório)</td>
    <td>Determina se o chat deve ser ativado.</td>
  </tr>
  </tbody>
</table>

##### PointsNotificationsActive

Controla se as notificações por pontos ganhos dos jogadores irão aparecer.

<table size="small">
	<thead>
		<tr>
			<th>Nome</th>
			<th>Tipo</th>
			<th>Padrão</th>
			<th>Descrição</th>
    </tr>
	</thead>
  <tbody>
	<tr>
    <td><code>active</code></td>
    <td>boolean</td>
    <td>(obrigatório)</td>
    <td>Determina se as notificações por pontos ganhos dos jogadores irão aparecer.</td>
  </tr>
  </tbody>
</table>

##### BadgesNotificationsActive

Controla se as notificações por emblemas ganhos irão aparecer.

<table size="small">
	<thead>
		<tr>
			<th>Nome</th>
			<th>Tipo</th>
			<th>Padrão</th>
			<th>Descrição</th>
      </tr>
	</thead>
  <tbody>
	<tr>
    <td><code>active</code></td>
    <td>boolean</td>
    <td>(obrigatório)</td>
    <td>Determina se as notificações por emblemas ganhos irão aparecer.</td>
  </tr>
  </tbody>
</table>

##### ResetButtonCallback

Determina o comportamento, se houver, do botão de reset dado um booleano ou um
`Class.BindableEvent` a ser disparado quando um jogador solicitar a reinicialização.

<table size="small">
	<thead>
		<tr>
			<th>Nome</th>
			<th>Tipo</th>
			<th>Padrão</th>
			<th>Descrição</th>
    </tr>
		</thead>
    <tbody>
	<tr>
    <td><code>enabled</code></td>
    <td>boolean</td>
    <td>(obrigatório)</td>
    <td>Determina se o botão de reset mantém seu comportamento padrão.</td>
  </tr>
	<tr>
    <td colspan="4"><b>OU</b></td>
  </tr>
	<tr>
    <td><code>callback</code></td>
    <td><code>Class.BindableEvent</code></td>
    <td>(obrigatório)</td>
    <td>Um <code>Class.BindableEvent</code> a ser disparado quando o jogador confirmar que deseja reiniciar.</td>
  </tr>
  </tbody>
</table>

##### ChatMakeSystemMessage

Exibe uma mensagem formatada no chat. Usar este método requer que a
`Class.TextChatService.ChatVersion` da experiência esteja configurada para
`Enum.ChatVersion|LegacyChatService`, embora o chat legado seja
**obsoleto** e seu uso seja desencorajado. Para experiências utilizando o atual
`Class.TextChatService`, consulte
`Class.TextChannel:DisplaySystemMessage()`.

<table size="small">
	<thead>
		<tr>
			<th>Nome</th>
			<th>Tipo</th>
			<th>Padrão</th>
			<th>Descrição</th>
      </tr>
	</thead>
  <tbody>
	<tr>
    <td><code>configTable</code></td>
    <td>dictionary</td>
    <td>(obrigatório)</td>
    <td>Um dicionário de informações descrevendo a mensagem (veja abaixo).</td>
  </tr>
  </tbody>
</table>

<table size="small">
	<thead>
		<tr>
			<th>Nome</th>
			<th>Tipo</th>
			<th>Padrão</th>
			<th>Descrição</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>Text</code></td>
    <td>string</td>
    <td>(obrigatório)</td>
    <td>A mensagem a ser exibida.</td>
  </tr>
	<tr>
    <td><code>Color</code></td>
    <td><code>Datatype.Color3</code></td>
    <td><code>Datatype.Color3.fromRGB(255, 255, 243)</code></td>
    <td>Cor do texto da mensagem.</td>
  </tr>
	<tr>
    <td><code>Font</code></td>
    <td><code>Enum.Font</code></td>
    <td><code>SourceSansBold</code></td>
    <td>Fonte da mensagem.</td>
  </tr>
	<tr>
    <td><code>TextSize</code></td>
    <td>integer</td>
    <td><code>18</code></td>
    <td>Tamanho do texto da mensagem.</td>
  </tr>
  </tbody>
</table>

##### SendNotification

Causa uma notificação não intrusiva a aparecer no canto inferior direito da
tela. A notificação pode ter até dois botões.

<table size="small">
	<thead>
		<tr>
			<th>Nome</th>
			<th>Tipo</th>
			<th>Padrão</th>
			<th>Descrição</th>
    </tr>
</thead>
  <tbody>
	<tr>
    <td><code>configTable</code></td>
    <td>dictionary</td>
    <td>(obrigatório)</td>
    <td>Um dicionário de informações descrevendo a notificação (veja abaixo).</td>
  </tr>
  </tbody>
</table>

<table size="small">
	<thead>
		<tr>
			<th>Nome</th>
			<th>Tipo</th>
			<th>Padrão</th>
			<th>Descrição</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>Title</code></td>
    <td>string</td>
    <td>(obrigatório)</td>
    <td>O título da notificação.</td>
  </tr>
	<tr>
    <td><code>Text</code></td>
    <td>string</td>
    <td>(obrigatório)</td>
    <td>O texto principal da notificação.</td>
  </tr>
	<tr>
    <td><code>Icon</code></td>
    <td>string</td>
    <td></td>
    <td>A imagem a ser exibida com a notificação.</td>
  </tr>
	<tr>
    <td><code>Duration</code></td>
    <td>number</td>
    <td><code>5</code></td>
    <td>Duração (em segundos) que a notificação deve permanecer visível.</td>
  </tr>
	<tr>
    <td><code>Callback</code></td>
    <td><code>Class.BindableFunction</code></td>
    <td></td>
    <td>Uma <code>Class.BindableFunction</code> que deve ser invocada com o texto do botão pressionado pelo jogador.</td>
  </tr>
	<tr>
    <td><code>Button1</code></td>
    <td>string</td>
    <td></td>
    <td>O texto a ser exibido no primeiro botão.</td>
  </tr>
	<tr>
    <td><code>Button2</code></td>
    <td>string</td>
    <td></td>
    <td>O texto a ser exibido no segundo botão.</td>
  </tr>
  </tbody>
</table>

##### TopbarEnabled

Determina se a barra superior está visível. Desativar a barra superior também
vai desativar todos os `Class.CoreGui|CoreGuis` como chat, inventário e
lista de jogadores (por exemplo, aqueles definidos com
`Class.StarterGui:SetCoreGuiEnabled()|SetCoreGuiEnabled`).

Quando desativada, a região que a barra superior ocupava ainda capturará
eventos de mouse; no entanto, os botões colocados lá não responderão a cliques.
A origem do espaço GUI ainda será deslocada 36 pixels do topo da
tela.

<table size="small">
	<thead>
		<tr>
			<th>Nome</th>
			<th>Tipo</th>
			<th>Padrão</th>
			<th>Descrição</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>enabled</code></td>
    <td>boolean</td>
    <td>(obrigatório)</td>
    <td>Determina se a barra superior deve ser visível.</td>
  </tr>
</tbody>
</table>

##### DevConsoleVisible

Determina se o
[Console do Desenvolvedor](/studio/developer-console) está visível.

<table size="small">
	<thead>
		<tr>
			<th>Nome</th>
			<th>Tipo</th>
			<th>Padrão</th>
			<th>Descrição</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>visibility</code></td>
    <td>boolean</td>
    <td>(obrigatório)</td>
    <td>Determina se o console está visível.</td>
  </tr>
</tbody>
</table>

##### PromptSendFriendRequest

Solicita ao jogador atual que envie uma solicitação de amizade para o
`Class.Player` fornecido.

<table size="small">
	<thead>
		<tr>
			<th>Nome</th>
			<th>Tipo</th>
			<th>Padrão</th>
			<th>Descrição</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>player</code></td>
    <td><code>Class.Player</code></td>
    <td>(obrigatório)</td>
    <td>O jogador para o qual a solicitação de amizade deve ser enviada.</td>
  </tr>
</tbody>
</table>

##### PromptUnfriend

Solicita ao jogador atual que remova um dado `Class.Player` de sua
lista de amigos.

<table size="small">
	<thead>
		<tr>
			<th>Nome</th>
			<th>Tipo</th>
			<th>Padrão</th>
			<th>Descrição</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>player</code></td>
    <td><code>Class.Player</code></td>
    <td>(obrigatório)</td>
    <td>O jogador que deve ser desconectado.</td>
  </tr>
</tbody>
</table>

##### PromptBlockPlayer

Solicita ao jogador atual que bloqueie o dado `Class.Player`.

<table size="small">
	<thead>
		<tr>
			<th>Nome</th>
			<th>Tipo</th>
			<th>Padrão</th>
			<th>Descrição</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>player</code></td>
    <td><code>Class.Player</code></td>
    <td>(obrigatório)</td>
    <td>O jogador que deve ser bloqueado.</td>
  </tr>
  </tbody>
</table>

##### PromptUnblockPlayer

Solicita ao jogador atual que desbloqueie o dado `Class.Player`.

<table size="small">
	<thead>
		<tr>
			<th>Nome</th>
			<th>Tipo</th>
			<th>Padrão</th>
			<th>Descrição</th>
    </tr>
 </thead>
 <tbody>
	<tr>
    <td><code>player</code></td>
    <td><code>Class.Player</code></td>
    <td>(obrigatório)</td>
    <td>O jogador que deve ser desbloqueado.</td>
  </tr>
  </tbody>
</table>

##### AvatarContextMenuEnabled

Determina se o
[Menu de Contexto do Avatar](/players/avatar-context-menu) está habilitado.

<table size="small">
	<thead>
		<tr>
			<th>Nome</th>
			<th>Tipo</th>
			<th>Padrão</th>
			<th>Descrição</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>enabled</code></td>
    <td>boolean</td>
    <td>(obrigatório)</td>
    <td>Determina se o menu de contexto está habilitado.</td>
  </tr>
</tbody>
</table>

##### AvatarContextMenuTarget

Abre forçosamente o
[Menu de Contexto do Avatar](/players/avatar-context-menu).

<table size="small">
	<thead>
		<tr>
			<th>Nome</th>
			<th>Tipo</th>
			<th>Padrão</th>
			<th>Descrição</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>player</code></td>
    <td><code>Class.Player</code></td>
    <td>(obrigatório)</td>
    <td>O jogador em que o menu de contexto será aberto.</td>
  </tr>
</tbody>
</table>

##### AddAvatarContextMenuOption

Adiciona uma opção ao
[Menu de Contexto do Avatar](/players/avatar-context-menu).

<table size="small">
	<thead>
		<tr>
			<th>Nome</th>
			<th>Tipo</th>
			<th>Padrão</th>
			<th>Descrição</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>option</code></td>
    <td><code>Enum.AvatarContextMenuOption</code></td>
    <td>(obrigatório)</td>
    <td>Opção a ser adicionada.</td>
  </tr>
	<tr>
    <td colspan="4"><b>OU</b></td>
  </tr>
	<tr>
    <td><code>option</code></td>
    <td>table</td>
    <td>(obrigatório)</td>
    <td>Uma tabela de dois elementos, onde o primeiro é o nome da ação personalizada, e o segundo é um <code>Class.BindableEvent</code> que será disparado quando um jogador for selecionado ao ativar a opção.</td>
  </tr>
</tbody>
</table>

##### RemoveAvatarContextMenuOption

Remove uma opção do
[Menu de Contexto do Avatar](/players/avatar-context-menu). O
argumento `option` deve ser o mesmo que foi usado com
`"AddAvatarContextMenuOption"` (veja acima).

<table size="small">
	<thead>
		<tr>
			<th>Nome</th>
			<th>Tipo</th>
			<th>Padrão</th>
			<th>Descrição</th>
    </tr>
</thead>
<tbody>
	<tr>
    <td><code>option</code></td>
    <td>Variant</td>
    <td>(obrigatório)</td>
    <td>O mesmo valor fornecido para <b>AddAvatarContextMenuOption</b>.</td>
  </tr>
  </tbody>
</table>

##### AvatarContextMenuTheme

Configura o personalizável
[Menu de Contexto do Avatar](/players/avatar-context-menu), que é um
recurso opcional que permite fácil interação social jogador-a-jogador via
ações personalizadas, como iniciar trocas, batalhas e mais. Para mais
informações sobre como personalizar seu tema, consulte o artigo
[Menu de Contexto do Avatar](/players/avatar-context-menu).

##### CoreGuiChatConnections

Configura uma conexão de gateway vinculável entre o botão do chat da barra
top do `Class.CoreGui` e o sistema de chat legado. O segundo parafímetro deve ser uma
tabela de `Class.BindableEvent|BindableEvents` e
`Class.BindableFunction|BindableFunctions`.


StarterGui:SetCore

Seleciona a funcionalidade com a qual a chamada irá interagir.

value

Uma tabela de `Class.BindableEvent|BindableEvents` e
`Class.BindableFunction|BindableFunctions`.

Permite que você realize certas interações com os scripts centrais do Roblox.

Esta função define se o elemento `Class.CoreGui` associado ao
`Enum.CoreGuiType` dado está habilitado ou desabilitado.

A barra superior não pode ser desabilitada usando esta função. Para desabilitá-la, defina
`"TopbarEnabled"` como `false` usando `Class.StarterGui:SetCore()`.

StarterGui:SetCoreGuiEnabled

enabled

Se deve habilitar ou desabilitar o dado `Enum.CoreGuiType`.

Define se o elemento `Class.CoreGui` associado ao dado
`Enum.CoreGuiType` está habilitado ou desabilitado.

StarterGui

Permite que `Class.StarterGui` processe entradas como `Class.PlayerGui` e
`Class.CoreGui` fazem. O valor padrão é `false`.

StarterGui.ProcessUserInput

Permite que este serviço processe entradas como `Class.PlayerGui` e
`Class.CoreGui` fazem.

Se definido como true, cada filho que está ligado ao `Class.StarterGui` será
clonado para o `Class.PlayerGui` de um jogador quando o personagem desse jogador
for reaparecido.

Se um dos filhos for um PlayerGui e tiver sua propriedade PlayerGui
definida como false, ele não será clonado.

StarterGui.ResetPlayerGuiOnSpawn

Determina se cada filho que está ligado ao StarterGui será clonado
para o PlayerGui de um jogador quando o personagem desse jogador for
reaparecido.

StarterGui.RtlTextSupport

Esta propriedade define o modo de orientação da tela preferido para usuários
com dispositivos móveis. Para os diferentes modos disponíveis, consulte
`Enum.ScreenOrientation`.

Por padrão, esta propriedade é definida como
`Enum.ScreenOrientation.Sensor|Sensor`, o que significa que a experiência é
displayada dependendo da melhor correspondência com a orientação atual do
dispositivo, seja paisagem (esquerda/direita) ou retrato.

Quando um `Class.Player` entra na experiência em um dispositivo móvel, esta
propriedade determina a orientação inicial do dispositivo e define a
`Class.PlayerGui.ScreenOrientation` daquele jogador de acordo. Você também
pode obter a orientação atual da tela do jogador através de
`Class.PlayerGui.CurrentScreenOrientation`, útil ao usar uma das
configurações de "sensor" `Enum.ScreenOrientation`.

Observe que alterar esta propriedade não mudará a orientação da tela
para `Class.Player|Players` já na experiência. Para mudar a
orientação de um jogador existente, use a propriedade
`Class.PlayerGui.ScreenOrientation` dele.

StarterGui.ScreenOrientation

Define o modo de orientação da tela padrão para usuários com dispositivos
móveis.

Esta propriedade determina se o conteúdo de `Class.StarterGui` é
visível no Studio.

StarterGui.ShowDevelopmentGui

Determina se o conteúdo de `Class.StarterGui` é visível no
Studio.

StarterGui.VirtualCursorMode

Um contêiner para objetos `Class.LayerCollector` a serem copiados para o
`Class.PlayerGui` de `Class.Player|Players`. Também fornece uma gama de
funções para interagir com o `Class.CoreGui`.

`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 do PlayerGui do jogador. Ambos são criados pelo
código de exemplo. Todos os GUIs de destaque são `Class.Instance:Destroy()`ados toda vez
que `highlightGui()` é executado.

Observe que `Class.ScreenGui.DisplayOrder` do HighlightContainer é 99999, um
número grande, de modo que é 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 diretamente objetos `Instance` raiz, mas o construtor especial
`Datatype.Instance.new()` cria objetos via código, recebendo o
nome da classe como um parâmetro e retornando o objeto criado.

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

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


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

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

Instance.AncestryChanged

child

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

parent

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

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

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

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

local part = Workspace.Part

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

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

Instance.AttributeChanged

attribute

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

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

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

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

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

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

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

Instance.ChildAdded

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

Instance.childAdded

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

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

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

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

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

Instance.ChildRemoved

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

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

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

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

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

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

Instance.DescendantAdded

descendant

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

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

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

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

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

#### Aviso

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

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

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

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

Instance.DescendantRemoving

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

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

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


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


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

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

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

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

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

Instance.Destroying

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

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

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

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("Propriedades de estilo alteradas")
end

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

Instance.StyledPropertiesChanged

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

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

#### Avisos

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

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

Instance:AddTag

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

Instance:children

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

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

-- Adiciona alguns brilhos
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

  local sc = Instance.new("Sparkles")
  sc.Parent = sparkles
end

print("Children:", #part:GetChildren())  --> Children: 3

part:ClearAllChildren()

print("Children:", #part:GetChildren())  --> Children: 0
```
Se você não desejar destruir **todos** os filhos e descendentes, use
`Class.Instance:GetChildren()` ou `Class.Instance:GetDescendants()` para
desloopar esses filhos/descendentes e selecionar o que deve ser destruído. Por
exemplo, o seguinte exemplo de código destruirá todos os`Class.BasePart|BaseParts`
descendentes de um `Class.Model`:

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

local model = Workspace:FindFirstChild("TestModel")

for _, descendant in model:GetDescendants() do
	if descendant:IsA("BasePart") then
		descendant:Destroy()
	end
end
```

Instance:ClearAllChildren

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

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

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

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

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

Instance:Clone

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

Instance:clone

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

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


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

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

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

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

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

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

Instance:Destroy

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

Instance:destroy

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

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

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

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

Instance:FindFirstAncestor

name

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

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

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

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

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

Instance:FindFirstAncestorOfClass

className

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

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

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

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

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

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

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

Instance:FindFirstAncestorWhichIsA

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

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

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

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

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

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

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

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

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

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

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

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

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

#### Notas de Desempenho

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

Instance:FindFirstChild

recursive

Se a busca deve ser realizada recursivamente.

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

Instance:findFirstChild

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

Instance:FindFirstChildOfClass

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

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

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

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

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

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

Instance:FindFirstChildWhichIsA

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

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

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

Instance:FindFirstDescendant

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

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

Instance:GetActor

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

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

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

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

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

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

#### Veja Também

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

Instance:GetAttribute

O nome do atributo que está sendo recuperado.

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

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

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

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

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

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

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

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

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

Instance:GetAttributeChangedSignal

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

Um evento que é acionado quando o atributo fornecido muda.

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

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

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

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

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

for name, value in part:GetAttributes() do
	print(name .. " = " .. value)
end
```
Veja também `Class.Instance:GetAttribute()` que retorna o valor que foi
atribuído ao nome do atributo fornecido.

Instance:GetAttributes

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

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

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

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

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

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

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

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

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

Instance:GetChildren

Um array contendo os filhos da instância.

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

Instance:getChildren

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

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

Instance:GetDebugId

scopeLength

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

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

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

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

Instance:GetDescendants

Um array contendo os descendentes da instância.

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

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

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

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

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

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

Instance:GetFullName

Retorna uma string descrevendo a ancestralidade da instância.

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

```lua
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")

local coreSheet = ReplicatedStorage:FindFirstChild("CoreSheet")
local rule = coreSheet:FindFirstChildWhichIsA("StyleRule")
rule.Selector = "TextButton"

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

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

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

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

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

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

Instance:GetStyled

selector

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

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

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

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

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

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

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("A propriedade de estilo mudou!")
end

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

Instance:GetStyledPropertyChangedSignal

property

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

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

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

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

Instance:GetTags

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

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

Instance:HasTag

Verifica se a instância tem uma tag dada.

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

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

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


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

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

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

Instance:IsAncestorOf

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

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

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

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

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

Instance:IsDescendantOf

ancestor

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

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

Instance:isDescendantOf

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

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

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

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

Instance:IsPropertyModified

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

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

Instance

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

/reference/engine/classes/StarterGui.yaml