`Class.GuiBase2d` es una clase abstracta heredada por 2D
`Class.GuiObject|GuiObjects`.


Este evento se activa cuando la selección del gamepad se mueve a, sale de, o cambia
dentro del `Class.GuiBase2d` conectado o cualquier descendiente
`Class.GuiObject|GuiObjects`. Cuando el resaltado de selección se mueve a un
`Class.GuiObject`, el evento burbujea desde ese `Class.GuiObject` a todos sus
ancestros, informándoles que la selección ha
cambiado/entrado/salido a un `Class.GuiObject` en su árbol de descendencia.


GuiBase2d.SelectionChanged

amISelected

Verdadero si la nueva selección coincide con el GuiBase2d adjunto.


previousSelection

newSelection

Se activa cuando la selección del gamepad se mueve a, sale de, o cambia dentro del
`Class.GuiBase2d` conectado o cualquier descendiente
`Class.GuiObject|GuiObjects`.


GuiBase2d

`Class.GuiBase2d.AbsolutePosition|AbsolutePosition` es una propiedad de solo lectura
que proporciona la posición en pantalla de un elemento `Class.GuiBase2d`
en píxeles. Esto representa la posición de píxeles real en la que un elemento
se renderiza como resultado de los tamaños y posiciones de sus ancestros. Nota que
`Class.GuiBase2d.AbsolutePosition|AbsolutePosition` siempre representa el
rincón superior izquierdo del elemento `Class.GuiBase2d`.

Si el `Class.GuiBase2d` se encuentra en un `Class.ScreenGui`, la
propiedad `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` utiliza el
sistema de coordenadas de vista `Enum.ScreenInsets|CoreUISafeInsets`. El
origen de este sistema de coordenadas se encuentra en la esquina inferior izquierda de
la barra superior de Roblox. Nota que este es el mismo sistema de coordenadas utilizado por
la propiedad `Class.InputObject.Position`.

<img src="/assets/engine-api/classes/GuiBase2d/AbsolutePositionCoordinateSystem.png" width="840" alt="Diagrama que muestra el origen del sistema de coordenadas AbsolutePosition." />

Ver también `Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation` y
`Class.GuiBase2d.AbsoluteSize|AbsoluteSize`.


GuiBase2d.AbsolutePosition

Describe la posición real en pantalla de un elemento `Class.GuiBase2d`, en
píxeles.


`Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation` es una propiedad de solo lectura
que describe la rotación real en pantalla de un elemento `Class.GuiBase2d`,
en grados. **No** realiza verificación de límites, por lo que su valor
puede no estar en el rango `0` a `360`.

Ver también `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` y
`Class.GuiBase2d.AbsoluteSize|AbsoluteSize`.


GuiBase2d.AbsoluteRotation

Describe la rotación real en pantalla de un elemento `Class.GuiBase2d`, en
grados.


`Class.GuiBase2d.AbsoluteSize|AbsoluteSize` es una propiedad de solo lectura que
describe el tamaño real en pantalla de un elemento `Class.GuiBase2d`, en
píxeles.

Ver también `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` y
`Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation`.


GuiBase2d.AbsoluteSize

Describe el tamaño real en pantalla de un elemento `Class.GuiBase2d`, en
píxeles.


Cuando se establece en `true`, la localización se aplicará a este `Class.GuiBase2d`
y sus descendientes. Las entradas utilizadas para la localización son el mismo conjunto de
entradas devueltas por `Class.LocalizationService:GetTableEntries()`. Las entradas
con `Class.GuiBase2d.AutoLocalize|AutoLocalize` habilitado se re-traducen automáticamente
después de que se cargue la tabla del cloud si es necesario.

Ver también `Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable`.


GuiBase2d.AutoLocalize

Cuando se establece en `true`, la localización se aplicará a este `Class.GuiBase2d`
y sus descendientes.


Esta propiedad se establece automáticamente en verdadero cuando una tabla de localización's
`Class.LocalizationTable.Root` apunta a este objeto, o a un ancestro de este
objeto. `Class.LocalizationTable|LocalizationTables` con su
propiedad `Class.LocalizationTable.Root` apuntando a una instancia
localiza todos los `Class.TextLabel.TextButton` que son descendientes de la raíz
instancia.


GuiBase2d.Localize

Automáticamente establecido en verdadero cuando un tabla de localización's
`Class.LocalizationTable.Root` apunta a este objeto, o a un ancestro de este
objeto.


Una referencia a una `Class.LocalizationTable` que se utilizará para aplicar
localización automatizada a este `Class.GuiBase2d` y sus descendientes.
`Class.GuiBase2d.AutoLocalize|AutoLocalize` debe estar configurado en `true` en el
`Class.GuiBase2d` y sus ancestros para que se aplique la localización automatizada.

Puedes configurar esto para hacer referencia a una `Class.LocalizationTable` en cualquier lugar en el
`Class.DataModel`. El objeto `Class.GuiBase2d` y todos sus hijos
intentarán usar esa tabla de localización específica y sus ancestros
para el reemplazo automático de texto antes de usar las tablas bajo
`Class.LocalizationService` en un orden indefinido y la tabla del cloud.

Si no hay traducción disponible en la tabla referenciada, buscará
una traducción en el padre de esa tabla, si también es un
`Class.LocalizationTable`, y así sucesivamente.

Ver también `Class.LocalizationService:GetTableEntries()` que explica cómo
la `Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable` se utiliza
para la localización automatizada.


GuiBase2d.RootLocalizationTable

Una referencia a una `Class.LocalizationTable` que se utilizará para aplicar
localización automatizada a este `Class.GuiBase2d` y sus descendientes.


Personaliza el comportamiento de selección del gamepad en la dirección abajo.


GuiBase2d.SelectionBehaviorDown

Personaliza el comportamiento de selección del gamepad en la dirección izquierda.


GuiBase2d.SelectionBehaviorLeft

Personaliza el comportamiento de selección del gamepad en la dirección derecha.


GuiBase2d.SelectionBehaviorRight

Personaliza el comportamiento de selección del gamepad en la dirección arriba.


GuiBase2d.SelectionBehaviorUp

Permite personalizar cómo la selección del gamepad puede moverse entre
botones, que son descendientes del grupo de selección, salir del grupo,
y seleccionar otros botones.

Establecer `Class.GuiBase2d.SelectionGroup|SelectionGroup` en `true` expone
las propiedades `Class.GuiBase2d.SelectionBehaviorUp|SelectionBehaviorUp`,
`Class.GuiBase2d.SelectionBehaviorDown|SelectionBehaviorDown`,
`Class.GuiBase2d.SelectionBehaviorLeft|SelectionBehaviorLeft`, y
`Class.GuiBase2d.SelectionBehaviorRight|SelectionBehaviorRight`.
Para estos comportamientos de selección, una configuración de
`Enum.SelectionBehavior.Escape` (predeterminado) significa que la selección del gamepad
intenta primero encontrar una selección dentro del grupo de selección y solo se mueve
afuera si no encuentra un botón adecuado. Alternativamente, una configuración de
`Enum.SelectionBehavior.Stop` significa que la selección del gamepad solo busca dentro
del grupo de selección y no se mueve fuera del grupo en la dirección del
comportamiento de selección.


GuiBase2d.SelectionGroup

Permite la personalización del movimiento de selección del gamepad.


Una clase abstracta heredada por 2D `Class.GuiObject|GuiObjects`.


GuiBase es una clase abstracta de la que heredan la mayoría de los objetos de interfaz gráfica de usuario.


GuiBase

`Instance` es la clase base para todas las clases en la jerarquía de clases de Roblox
que pueden ser parte del árbol `Class.DataModel`.

No es posible crear objetos raíz `Instance` directamente, pero el constructor especial
`Datatype.Instance.new()` crea objetos a través del código, tomando el
nombre de la clase como parámetro y devolviendo el objeto creado.

Demuestra la detección de cambios en la ascendencia de una instancia al conectarse al evento `Class.Instance.AncestryChanged`.
El Padre de ChangingPart se establece en diferentes valores con el tiempo. El padre de la parte es el ancestro de la parte, por lo que el evento `Class.Instance.AncestryChanged` se activará cada vez que cambie.

Se activa cuando la propiedad `Class.Instance.Parent` del objeto o uno de
sus ancestros es cambiada.

Este evento incluye dos parámetros: `child` se refiere al `Class.Instance`
cuya `Class.Instance.Parent` fue realmente cambiada, mientras que `parent` se refiere
a el nuevo `Class.Instance.Parent` de esta instancia.

Puedes usar este evento para rastrear la eliminación de una instancia en Studio,
such as manual deletion in the Explorer or through a plugin. Si necesitas
detectar cuando una instancia es destruida usando `Class.Instance:Destroy()`,
usa el evento `Class.Instance.Destroying` en su lugar.

Instance.AncestryChanged

child

El `Class.Instance` cuya `Class.Instance.Parent` ha sido cambiada.

parent

El nuevo `Class.Instance.Parent` del `Class.Instance` cuya
`Class.Instance.Parent` fue cambiada.

Se activa cuando la propiedad `Class.Instance.Parent` del objeto o uno de
sus ancestros es cambiada.

Este evento se activa cada vez que se cambia cualquier atributo en la instancia,
incluyendo cuando un atributo se establece en `nil`. El nombre del atributo cambiado
se pasa a la función conectada.

Por ejemplo, el siguiente fragmento de código conecta la función `attributeChanged()`
para activarse cada vez que uno de los atributos de la parte cambia:

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

local part = Workspace.Part

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

part.AttributeChanged:Connect(attributeChanged)
```
Consulta también `Class.Instance:GetAttributeChangedSignal()` que devuelve un
evento que se activa cuando un atributo específico dado cambia.

Instance.AttributeChanged

attribute

El nombre del atributo que ha sido cambiado.

Se activa cada vez que se cambia un atributo en el `Class.Instance`.

Este fragmento imprime los nombres de los objetos a medida que se añaden al Espacio de Trabajo:

Se activa después de que un objeto se parenta a esta `Class.Instance`.

Ten en cuenta que, al usar este método en un cliente para detectar objetos creados por el
servidor, es necesario usar `Class.Instance:WaitForChild()` al indexar los descendientes de estos
objetos. Esto se debe a que el objeto y sus descendientes no están garantizados para
replicarse del servidor al cliente simultáneamente. Por ejemplo:

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

Workspace.ChildAdded:Connect(function(child)
	-- Usa WaitForChild() ya que los descendientes pueden no haberse replicado aún
	local head = child:WaitForChild("Head")
end)
```
Ten en cuenta que este evento solo opera para hijos inmediatos de la
`Class.Instance`. Para un evento que capture todos los descendientes,
usa `Class.Instance.DescendantAdded`.

Consulta también `Class.Instance.ChildRemoved`.

Instance.ChildAdded

El `Class.Instance` que ha sido agregado.

Se activa después de que un objeto ha sido parentado a esta `Class.Instance`.

Este fragmento imprime los nombres de los objetos a medida que se eliminan del
Espacio de trabajo:

Se activa después de que un hijo es eliminado de esta `Class.Instance`.

Eliminado se refiere a cuando el padre de un objeto cambia de esta
`Class.Instance` a algo diferente a esta `Class.Instance`. Ten en cuenta que este
evento también se activará cuando un hijo sea destruido (usando
`Class.Instance:Destroy()`) ya que la función de destrucción establece el padre de un objeto en `nil`.

Este evento solo opera para hijos inmediatos de la `Class.Instance`.
Para un evento que capture todos los descendientes, usa
`Class.Instance.DescendantRemoving`.

Consulta también `Class.Instance.ChildAdded`.

Instance.ChildRemoved

El `Class.Instance` que ha sido eliminado.

Se activa después de que un hijo ha sido eliminado de esta `Class.Instance`.

Este siguiente ejemplo imprimirá el nombre de cualquier objeto que se agregue al
Espacio de trabajo:

Este evento se activa después de que un descendiente ha sido añadido a la `Class.Instance`.

Dado que se activa para cada descendiente, agregar un objeto a la
`Class.Instance` activa el evento para este objeto y todos sus
descendientes individualmente.

Si solo te preocupan los **hijos directos** de la
`Class.Instance`, usa `Class.Instance.ChildAdded` en su lugar.

Consulta también `Class.Instance.DescendantRemoving`.

Instance.DescendantAdded

descendant

Se activa después de que un descendiente ha sido añadido a la `Class.Instance`.

El siguiente ejemplo imprime el nombre de cualquier descendiente mientras se está eliminando
del Workspace:

Este evento se activa **inmediatamente antes** de que el `Class.Instance` padre
cambie de tal manera que una instancia **descendiente** ya no será un
descendiente. `Class.Instance:Destroy()|Destroy()` cambia el
`Class.Instance.Parent|Parent` de una instancia a `nil`, por lo que llamar a ese método en un
descendiente del padre hará que se active este evento.

Dado que este evento se activa **antes** de la eliminación del descendiente, el padre del
descendiente no cambiará en el momento en que se active este evento. Si el
descendiente también es un **hijo directo** del padre, este evento se activará
antes de `Class.Instance.ChildRemoved`.

Si un descendiente tiene hijos, este evento se activa primero con el descendiente,
siguido por sus descendientes.

##### Advertencia

Este evento se activa con el objeto descendiente que está siendo eliminado.
Intentar establecer el `Class.Instance.Parent|Parent` del descendiente a
algo más fallará. A continuación, se muestra un ejemplo que demuestra esto:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- ¡No manipules el padre del descendiente en esta función!
	-- Este evento se activa PORQUE se manipuló el padre, y el cambio aún no ha ocurrido
	-- Por lo tanto, es problemático cambiar el padre de esta manera:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Consulta también `Class.Instance.DescendantAdded|DescendantAdded`.

Instance.DescendantRemoving

El `Class.Instance` que está siendo eliminado.

Se activa inmediatamente antes de que un descendiente de `Class.Instance` sea eliminado.

Esta muestra demuestra cómo, al usar el comportamiento de señales inmediatas, una Instancia que se está destruyendo permanece en su lugar hasta que la función conectada cede.

Esta muestra demuestra cómo, al usar el comportamiento de señales diferidas,
una Instancia es destruida antes de que se dispare la señal.

El `Class.Instance` nunca será eliminado de la memoria mientras una función conectada
lo esté utilizando. Sin embargo, si la función se detiene en algún momento,
el `Class.Instance` y sus descendientes serán asignados a `nil`.

Si la propiedad `Class.Workspace.SignalBehavior` está establecida en
`Enum.SignalBehavior.Immediate`, este evento se activa inmediatamente antes de que el
`Class.Instance` o uno de sus ancestros sea eliminado con
`Class.Instance:Destroy()`.

Si la propiedad `Class.Workspace.SignalBehavior` está establecida en
`Enum.SignalBehavior.Deferred`, este evento se activa en el siguiente punto de reanudación,
lo que será después de que el `Class.Instance` o uno de sus ancestros sea
eliminado con `Class.Instance:Destroy()`.

Con el comportamiento `Enum.SignalBehavior.Deferred|Deferred`, conectar un script
a su propio evento `Class.Instance.Destroying` es problemático, ya que el script
será destruido antes de que se pueda llamar la devolución de llamada (lo que significa que no se ejecutará).

Al eliminar un `Class.Instance` en Studio, como eliminarlo manualmente
a través del [Explorer](/studio/explorer) o a través de un plugin,
el `Class.Instance` no se destruye. En su lugar, el padre se establece en `nil`
lo cual puedes rastrear con `Class.Instance.AncestryChanged`.

Instance.Destroying

Se activa inmediatamente antes (o se retrasa hasta después) de que la instancia es
eliminada a través de `Class.Instance:Destroy()`.

Este evento se activa siempre que se cambie cualquier propiedad de estilo en la instancia,
incluyendo cuando una propiedad se establece en `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("Propiedades de estilo cambiadas")
end

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

Instance.StyledPropertiesChanged

Se activa siempre que se cambie cualquier propiedad de estilo en la instancia, incluyendo
cuando una propiedad se establece en `nil`.

Instance.childAdded

Este método aplica una etiqueta a la instancia, sin efecto si la etiqueta ya
está aplicada. Agregar una etiqueta con éxito activará una señal creada por
`Class.CollectionService:GetInstanceAddedSignal()` con la etiqueta dada.

##### Advertencias

- Las etiquetas de una instancia que fueron añadidas del lado del cliente serán
  descartadas si el servidor luego agrega o quita una etiqueta de esa instancia porque el servidor
  replica todas las etiquetas juntas y sobrescribe etiquetas anteriores.

- Al etiquetar una instancia, es común que se utilicen algunos recursos para
  proporcionar funcionalidad a la etiqueta, como conexiones de eventos o tablas.
  Para prevenir pérdidas de memoria, es una buena idea limpiar estos (desconectar,
  establecer en `nil`, etc.) cuando ya no sean necesarios para una etiqueta. Hacer esto al
  llamar a `Class.Instance:RemoveTag()`, llamando a
  `Class.Instance:Destroy()`, o en una función conectada a una señal
  devuelta por `Class.CollectionService:GetInstanceRemovedSignal()`.

Instance:AddTag

Este método destruye todos los hijos y descendientes de una instancia.

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

-- Añadir algunos destellos
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
```
Si no deseas destruir **todos** los hijos y descendientes, usa `Class.Instance:GetChildren()` o `Class.Instance:GetDescendants()` para recorrer esos hijos/descendientes y seleccionar qué destruir. Por ejemplo, el siguiente fragmento de código destruirá todos los `Class.BasePart|BaseParts` que desciendan de un `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 destruye todos los hijos de una instancia.

Demuestra cómo clonar un modelo usando `Class.Instance:Clone()`.

`Clone()` crea una copia de una instancia y de todos sus descendientes,
ingresando todas las instancias que no son
`Class.Instance.Archivable|Archivable`. La copia de la instancia raíz es
devuelta por este método y su `Class.Instance.Parent|Parent` se establece en
`nil`. Tenga en cuenta que si la instancia misma tiene
`Class.Instance.Archivable|Archivable` establecido en `false`, este método
retornará `nil`.

Si una propiedad de referencia, como `Class.ObjectValue.Value`, se establece en una
instancia clonada, el valor de la propiedad de la copia depende del
valor del original:

- Si una propiedad de referencia se refiere a una instancia que fue **también** clonada,
  la copia se referirá a la copia.
- Si una propiedad de referencia se refiere a una instancia que **no** fue clonada,
  el mismo valor se mantiene en la copia.


Instance:Clone

Crea una copia de una instancia y todos sus descendientes, ignorando las instancias
que no son `Class.Instance.Archivable|Archivable`.

Demuestra cómo destruir un Part utilizando la función `Class.Instance:Destroy()`.

Esta función es la manera correcta de deshacerse de objetos que ya no son necesarios.

Establece la propiedad `Class.Instance.Parent` en `nil`, bloquea la
propiedad `Class.Instance.Parent`, desconecta todas las conexiones y llama a
`Destroy()` en todos los hijos. Este método es la forma correcta de eliminar
objetos que ya no son necesarios.

Eliminar objetos innecesarios es importante, ya que los objetos y
conexiones innecesarios en un lugar consumen memoria, lo que puede llevar a serios problemas de rendimiento con el tiempo.

Como buena práctica, después de llamar a `Destroy()` en un objeto, establece cualquier
variable que haga referencia al objeto (o sus descendientes) en `nil`. Esto
previene que tu código acceda a cualquier cosa relacionada con el objeto.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- No hagas esto:
print(part.Name)  --> "Hello, world"
-- Haz esto para evitar que la línea anterior funcione:
part = nil
```
Una vez que una `Class.Instance` ha sido destruida por este método, no puede ser
reutilizada porque la propiedad `Class.Instance.Parent` está bloqueada. Para
**eliminar temporalmente** un objeto en lugar de destruirlo, establece
`Class.Instance.Parent|Parent` en `nil`. Por ejemplo:

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Para destruir un objeto después de un tiempo determinado, usa
`Class.Debris:AddItem()`.

Instance:Destroy

Establece la propiedad `Class.Instance.Parent` a `nil`, bloquea la
propiedad `Class.Instance.Parent`, desconecta todas las conexiones, y llama a
`Destroy()` en todos los hijos.

Devuelve el primer antepasado de la `Class.Instance` cuyo
`Class.Instance.Name` es igual al nombre dado.

Este método trabaja hacia arriba, lo que significa que comienza en el
`Class.Instance.Parent` inmediato de la instancia y trabaja hacia el `Class.DataModel`. Si no se encuentra un antepasado coincidente, devuelve `nil`.

El siguiente fragmento de código encontraría el primer antepasado del objeto
llamado `Car`.

```
local car = object:FindFirstAncestor("Car")
```
Para variantes de este método que encuentran antepasados de una clase específica,
consulta `Class.Instance:FindFirstAncestorOfClass()` y
`Class.Instance:FindFirstAncestorWhichIsA()`.

Instance:FindFirstAncestor

name

Devuelve el primer antepasado del `Class.Instance` cuyo
`Class.Instance.Name` es igual al nombre dado.

Devuelve el primer antepasado de la `Class.Instance` cuyo
`Class.Object.ClassName` es igual al `className` dado.

Este método trabaja hacia arriba, lo que significa que comienza en el
`Class.Instance.Parent` inmediato de la instancia y trabaja hacia el `Class.DataModel`. Si no se encuentra un antepasado coincidente, devuelve `nil`.

Un uso común de este método es encontrar el `Class.Model` al que
pertenece un `Class.BasePart`. Por ejemplo:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Este método es una variante de `Class.Instance:FindFirstAncestor()` que
verifica la propiedad `Class.Object.ClassName` en lugar de `Class.Instance.Name`. También existe `Class.Instance:FindFirstAncestorWhichIsA()`, que utiliza el método `Class.Object:IsA()` para respetar la herencia de clases.

Instance:FindFirstAncestorOfClass

className

El `Class.Object.ClassName` que se busca.

Devuelve el primer antepasado del `Class.Instance` cuyo
`Class.Object.ClassName` es igual al `className` dado.

Devuelve el primer antepasado de la `Class.Instance` para el cual
`Class.Object:IsA()` devuelve verdadero para el `className` dado.

Este método trabaja hacia arriba, lo que significa que comienza en el
`Class.Instance.Parent` inmediato de la instancia y trabaja hacia el `Class.DataModel`. Si no se encuentra un antepasado coincidente, devuelve `nil`.

A diferencia de `Class.Instance:FindFirstAncestorOfClass()`, este método utiliza
`Class.Object:IsA()` que respeta la herencia de clases. Por ejemplo:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Por lo tanto, el siguiente ejemplo de código devolverá el primer
antepasado de `Class.BasePart`, independientemente de si es un `Class.WedgePart`,
`Class.MeshPart` o `Class.Part`.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Consulta también `Class.Instance:FindFirstAncestor()`.

Instance:FindFirstAncestorWhichIsA

Devuelve el primer antepasado del `Class.Instance` para el cual
`Class.Object:IsA()` devuelve verdadero para el `className` dado.

A continuación, buscaría en Workspace un objeto llamado "Brick". Si se encuentra, cambiará el nombre del objeto a "Foo".

Devuelve el primer hijo de la `Class.Instance` con el nombre dado, o
`nil` si no existe tal hijo. Si el argumento opcional `recursive` es
`true`, este método busca en todos los descendientes en lugar de solo en los
hijos inmediatos de la `Class.Instance`.

##### Comprobando la Existencia de un Objeto

`FindFirstChild()` es necesario si necesitas verificar que un objeto exista
antes de continuar. Intentar indexar un hijo por nombre utilizando el operador de punto
lanza un error si el hijo no existe.

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

-- La siguiente línea provoca error si el part no existe en el workspace
Workspace.Part.Transparency = 0.5
```
Un enfoque mejor es usar `FindFirstChild()` para primero comprobar si `Part`,
luego usar una declaración `if` para ejecutar código que lo necesite.

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

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

##### Encontrando un Hijo cuyo Nombre Coincide con una Propiedad

A veces el `Class.Instance.Name|Name` de un objeto es el mismo que el de una
propiedad de su `Class.Instance.Parent|Parent`. Al usar el operador de punto,
las propiedades tienen prioridad sobre los hijos si comparten un nombre.

En el siguiente ejemplo, se agrega una `Class.Folder` llamada `Color` a un
`Class.Part`, que también tiene la propiedad `Class.Part.Color`. Ten en cuenta que
`part.Color` se refiere al valor de la propiedad `Datatype.Color3`, no a la instancia de la
`Class.Folder` hijo. Una ventaja de usar
`Class.Instance:FindFirstChild()|FindFirstChild()` es que la introducción de nuevas propiedades
no representa un riesgo para tu código.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- La propiedad
local c2 = part:FindFirstChild("Color")  -- La carpeta hija
```

##### Notas de Rendimiento

`Class.Instance:FindFirstChild()|FindFirstChild()` tarda aproximadamente un 20%
más que usar el operador de punto y casi 8 veces más que simplemente almacenar
una referencia a un objeto. Por lo tanto, debes evitar llamarlo en código que dependa del rendimiento,
como en bucles cerrados o funciones conectadas a `Class.RunService.Heartbeat` y
`Class.RunService.PreRender`. En su lugar, almacena el resultado en una
variable, o considera usar
`Class.Instance.ChildAdded|ChildAdded` o
`Class.Instance:WaitForChild()|WaitForChild()` para detectar cuándo un hijo de un
given nombre se vuelve disponible.

Instance:FindFirstChild

recursive

Si la búsqueda debe realizarse de manera recursiva o no.

Devuelve el primer hijo del `Class.Instance` encontrado con el nombre ofrecido.

Devuelve el primer hijo de la `Class.Instance` cuyo
`Class.Object.ClassName|ClassName` es igual al `className` dado.
A diferencia de `Class.Instance:FindFirstChildWhichIsA()`, este método solo devuelve
objetos cuya clase coincide con `className`, ignorando la herencia de clases. Si no se
encuentra un hijo coincidente, este método devuelve `nil`.

Instance:FindFirstChildOfClass

Devuelve el primer hijo del `Class.Instance` cuyo
`Class.Object.ClassName|ClassName` es igual al nombre de clase dado.

Devuelve el primer hijo de la `Class.Instance` para el cual
`Class.Object:IsA()` devuelve verdadero para el `className` dado.

Si no se encuentra un hijo coincidente, este método devuelve `nil`. Si el argumento opcional
`recursive` es verdadero, este método busca en todos los descendientes en lugar
solo de los hijos inmediatos de la `Class.Instance`.

A diferencia de `Class.Instance:FindFirstChildOfClass()`, este método utiliza
`Class.Object:IsA()` que respeta la herencia de clases. Por ejemplo:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Por lo tanto, el siguiente ejemplo de código devolverá el primer
hijo `Class.BasePart`, independientemente de si es un `Class.WedgePart`,
`Class.MeshPart` o `Class.Part`.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Los desarrolladores que buscan un hijo por nombre, deben usar
`Class.Instance:FindFirstChild()` en su lugar.

Instance:FindFirstChildWhichIsA

Si la búsqueda debe ser realizada de manera recursiva o no.

Devuelve el primer hijo del `Class.Instance` para quien
`Class.Object:IsA()` devuelve verdadero para el `className` dado.

Devuelve el primer descendiente encontrado con el `Class.Instance.Name` dado.

Este método está deshabilitado y no puede ser utilizado. Para encontrar el primer descendiente
de una instancia, considera usar el parámetro `recursive` en
`Class.Instance:FindFirstChild()` en su lugar.

Instance:FindFirstDescendant

Devuelve el primer descendiente encontrado con el `Class.Instance.Name` dado.

Si el `Class.Instance` es un `Class.Actor`, el `Class.Actor` en sí mismo es
devuelto. De lo contrario, se devuelve su antepasado más cercano `Class.Actor`. Si ningún
antepasado es un `Class.Actor`, el resultado es `nil`.

Instance:GetActor

Devuelve el `Class.Actor` asociado con la instancia, si existe.

Este método devuelve el valor que se ha asignado al nombre de atributo dado. Si
no se ha asignado ningún atributo, se devuelve `nil`.

Por ejemplo, el siguiente fragmento de código establece y luego obtiene el valor del
atributo `InitialPosition` de la instancia:

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

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

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

##### Ver también

- `Class.Instance:SetAttribute()` que establece el atributo con el nombre dado
a el valor dado.
- `Class.Instance:GetAttributes()` que devuelve un diccionario de pares clave-valor
  para cada uno de los atributos de la instancia.

Instance:GetAttribute

El nombre del atributo que se recuperará.

El valor que se ha asignado al nombre de atributo dado. Si no
se ha asignado ningún atributo, se devuelve `nil`.

Devuelve el valor que se ha asignado al nombre de atributo dado.

Este método devuelve un evento que se comporta exactamente como el
evento `Class.Object.Changed|Changed`, excepto que solo se activa cuando el
atributo específico dado cambia; efectivamente es similar a
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` pero
para atributos.

Es generalmente una buena idea usar este método en lugar de una conexión a
`Class.Object.Changed|Changed` con una función que verifica el nombre del atributo.
Las llamadas subsecuentes a este método en el mismo objeto con el mismo
nombre de atributo devuelven el mismo evento.

El siguiente ejemplo de código devuelve una señal que activa la función
`attributeChanged()` cuando el atributo `InitialPosition` del parte cambia:

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

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

local function attributeChanged()
	print("Attribute changed")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
Consulta también `Class.Instance.AttributeChanged`, que se activa cada vez que se
cambia cualquier atributo de la instancia.

Instance:GetAttributeChangedSignal

El nombre del atributo especificado para el cual se está devolviendo la señal de cambio.

Un evento que se activa cuando cambia el atributo dado.

Devuelve un evento que se activa cuando cambia el atributo dado.

Este método devuelve un diccionario de pares clave-valor para cada atributo
donde la clave es el nombre del atributo y el valor es un valor no `nil`.

Por ejemplo, el siguiente fragmento de código muestra los atributos y valores de una instancia:

```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
```
Consulta también `Class.Instance:GetAttribute()` que devuelve el valor que se ha
asignado al nombre de atributo dado.

Instance:GetAttributes

Un diccionario de pares cadena → variante para cada atributo donde la
cadena es el nombre del atributo y la variante es un valor no-nil.

Devuelve un diccionario de los atributos de la instancia.

A continuación se imprimiría el nombre de todos los objetos actualmente en Workspace cuando se ejecuta.

Devuelve un arreglo (una tabla indexada numéricamente) que contiene todos los
hijos directos de la instancia, o cada `Class.Instance` cuyo
`Class.Instance.Parent|Parent` es igual al objeto. El arreglo se puede
iterar usando ya sea un bucle numérico o un bucle `for` genérico:

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

-- Ejemplo de bucle numérico
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " es el hijo número " .. i)
end
```

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

-- Ejemplo de bucle genérico
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " es el hijo número " .. i)
end
```
Ten en cuenta que el arreglo **no** está ordenado en ningún orden en particular,
por lo que se recomienda ordenar manualmente (por ejemplo, usando `Library.table.sort()`)
los hijos devueltos por este método.

Consulta también el método `Class.Instance:GetDescendants()|GetDescendants()`.

Instance:GetChildren

Un array que contiene los hijos de la instancia.

Devuelve un array que contiene todos los hijos de la instancia.

Devuelve una cadena codificada del ID de depuración utilizado internamente por Roblox. Nota
que:

- Este elemento está protegido. Intentar usarlo en un `Class.Script` o
  `Class.LocalScript` provocará un error.
- Un ID de depuración es un ID utilizado en procesos de depuración. Permite a un depurador
  leer cada instrucción antes de que una aplicación la procese. Todos los objetos en
  Roblox actúan como procesos y cada ejecución de instrucciones (o 'código') que puede
  ser depurada si es necesario.
- Esto puede ser útil para los complementos que necesitan distinguir objetos similares
de unos a otros (como objetos que comparten el mismo nombre).

Instance:GetDebugId

scopeLength

Devuelve una cadena codificada del ID de depuración utilizado internamente por Roblox.

GetDescendants se usa a menudo para hacer algo con todos los descendientes que son un
tipo particular de objeto. El código en este ejemplo utiliza GetDescendants y
`Class.Instance:IsA()` para encontrar todas las partes en el espacio de trabajo y las
convierte en verdes.

Este método de objeto devuelve un array que contiene todos los descendientes
de ese objeto. A diferencia de `Class.Instance:GetChildren()`, que solo devuelve
los hijos inmediatos de un objeto, este método encuentra cada hijo del
objeto, cada hijo de esos hijos, y así sucesivamente.

Instance:GetDescendants

Un array que contiene los descendientes de la instancia.

Devuelve un array que contiene todos los descendientes de la instancia.

Este ejemplo de código demuestra el comportamiento de `Class.Instance:GetFullName()`.
Muestra cómo se comporta la función cuando se llama a un objeto que no está en la
jerarquía de `DataModel`, y también muestra cómo el valor de retorno no escapa
caracteres especiales.

Este ejemplo de código reimplementa la función `Class.Instance:GetFullName()` en
Lua.

Devuelve una cadena que describe la ascendencia de la instancia. La cadena es una
concatenación del `Class.Instance.Name|Name` del objeto y sus
antepasados, separados por puntos. El `Class.DataModel` (`game`) no se
considera. Por ejemplo, un `Class.Part` en el `Class.Workspace` puede
devolver `Class.Workspace.Part`.

Cuando se llama en una `Class.Instance` que no es un descendiente del
`Class.DataModel`, este método considera todos los antepasados hasta
incluir el más alto que no tenga un `Class.Instance.Parent|Parent`.

Este método es útil para registrar y depurar. No debes intentar
analizar la cadena devuelta para ninguna operación útil; este método no
escapa puntos (ni ningún otro símbolo) en los nombres de los objetos. En otras
palabras, aunque su salida a menudo parece ser un identificador válido de Luau,
no está garantizado.

Instance:GetFullName

El nombre completo de la `Class.Instance`.

Devuelve una cadena que describe la ascendencia de la instancia.

Este método devuelve el valor estilizado o explícitamente modificado de la
propiedad especificada, o el valor de propiedad predeterminado si no ha sido
estilizado/modificado. Esto difiere ligeramente de acceder al valor de la propiedad
directamente, como `[GuiObject].Rotation`, que devuelve el valor predeterminado o
modificado de la propiedad.

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

-- Referencia a un botón
local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

print(button:GetStyled("Rotation")) --> 0 (valor predeterminado)
print(button.Rotation) --> 0 (valor predeterminado)

-- Aplicar rotación a través de la propiedad de regla de estilo
rule:SetProperty("Rotation", 30)

print(button:GetStyled("Rotation")) --> 30 (valor estilizado basado en la regla)
print(button.Rotation) --> 0 (valor predeterminado)

-- Modificar/anteponer explícitamente la propiedad estilizada
button.Rotation = 45

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

Instance:GetStyled

El valor estilizado o explícitamente modificado de la propiedad especificada, o
el valor predeterminado de la propiedad si no ha sido estilizado/modificado.

Devuelve el valor estilizado o explícitamente modificado de la propiedad especificada,
o el valor de propiedad predeterminado si no ha sido estilizado/modificado.

Este método devuelve un evento que se comporta exactamente como el
evento `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`,
excepto que solo se activa cuando cambia la propiedad de estilo dada. Generalmente,
es una buena idea usar este método en lugar de una conexión a
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` con una
función que verifique el nombre de propiedad. Las llamadas subsiguientes a este método en
el mismo objeto con el mismo nombre de propiedad devuelven el mismo evento.

Nota que este evento no pasará argumentos a una función conectada,
por lo que el valor de la propiedad cambiada debe ser leído directamente dentro de un
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("¡Propiedad de estilo cambiada!")
end

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

Instance:GetStyledPropertyChangedSignal

property

Nombre de la propiedad de estilo para la cual escuchar cambios.

Evento que se activa cuando cambia la propiedad de estilo dada.

Este método devuelve un array de las etiquetas aplicadas a la instancia dada, como
cadenas. Puedes agregar etiquetas ya sea en Studio en la
[ventana de Propiedades](/studio/properties) o en tiempo de ejecución con
`Class.Instance:AddTag()|AddTag()`.

Este método es útil cuando deseas hacer algo con múltiples etiquetas en
una instancia a la vez. Sin embargo, es ineficiente usar este método para
verificar la existencia de una sola etiqueta; en su lugar, usa
`Class.Instance:HasTag()|HasTag()` para comprobar una etiqueta específica.

Instance:GetTags

Obtiene un array de todas las etiquetas aplicadas a la instancia.

Este método devuelve `true` si la etiqueta proporcionada ha sido añadida al
objeto. Puedes agregar etiquetas ya sea en Studio en la
[ventana de Propiedades](/studio/properties) o en tiempo de ejecución con
`Class.Instance:AddTag()|AddTag()`.

Instance:HasTag

Verifica si la instancia tiene una etiqueta dada.

Demuestra cómo determinar si una instancia es el ancestro de otra usando `Class.Instance:IsAncestorOf()`
Workspace y SpawnLocation son ancestros del decal de SpawnLocation.
Workspace es un ancestro de SpawnLocation.
SpawnLocation y su decal son descendientes de Workspace, no ancestros.
Decal es un descendiente de SpawnLocation, no un ancestro.

Devuelve verdadero si un `Class.Instance` es un antepasado del dado
descendiente.

Se considera que un `Class.Instance` es el antepasado de un objeto si el
`Class.Instance.Parent` del objeto o uno de sus padres
`Class.Instance.Parent` se establece en el `Class.Instance`.

Consulta también, `Class.Instance:IsDescendantOf()`.

Instance:IsAncestorOf

Verdadero si el `Class.Instance` es un antepasado del dado descendiente.

Devuelve verdadero si un `Class.Instance` es un antepasado del dado
descendiente.

Devuelve `true` si un `Class.Instance` es un descendiente del dado
antepasado.

Nota que `IsDescendantOf()` no puede ser utilizado con un parámetro de `nil` para
verificar si un objeto ha sido eliminado.

Consulta también `Class.Instance:IsAncestorOf()`.

Instance:IsDescendantOf

ancestor

Verdadero si el `Class.Instance` es un descendiente del dado antepasado.

Devuelve `true` si un `Class.Instance` es un descendiente del dado
antepasado.

Este método indica si una propiedad específica ha sido modificada desde el
defecto instanciado en código. Si se llama a una instancia creada recientemente a través de
código (`Datatype.Instance.new()`), este método devolverá `false`. Si
se llama a un objeto creado recientemente por flujos de trabajo de Studio como la
inserción de la ventana [Explorer](/studio/explorer), el resultado puede
diferir.

Por ejemplo, consultar la
`Class.TextLabel.BackgroundColor3|BackgroundColor3` propiedad de un
`Class.TextLabel` insertado a través del [Explorer](/studio/explorer)
retornará `true`, pero consultar la misma propiedad de un `Class.TextLabel`
creado a través de `Datatype.Instance.new()` devolverá `false`, suponiendo que no
se realizaron otros cambios a su
`Class.TextLabel.BackgroundColor3|BackgroundColor3`.

Tenga en cuenta que si este método devuelve `true`, el estilo **no** afectará a la
propiedad porque modificar explícitamente una propiedad tiene prioridad sobre
estilizarla. Para restablecer una propiedad a su valor por defecto instanciado en código y permitir
el estilo en ella, use
`Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()`.


Instance:IsPropertyModified

Booleano que indica si la propiedad ha sido modificada respecto a su
valor por defecto instanciado en código.


Devuelve `true` si el valor almacenado en la propiedad especificada no es igual
a el valor por defecto instanciado en código.


El siguiente código demuestra cómo una parte puede ser agregada nuevamente al DataModel
después de haber sido eliminada:

Este método establece la `Class.Instance.Parent` del objeto en `nil`, y hace
lo mismo para todos sus descendientes.

Si el objeto se hace referencia antes de ser eliminado, es posible recuperar
el objeto en un momento posterior.

Instance:Remove

Establece el `Parent` del objeto a `nil`, y hace lo mismo con todos sus
descendientes.

Este método elimina una etiqueta de una instancia. No lanzará un error si
el objeto no tiene la etiqueta. Eliminar exitosamente una etiqueta disparará una
señal creada por `Class.CollectionService:GetInstanceRemovedSignal()`
con la etiqueta dada.

Nota que al etiquetar una instancia, es común que se utilicen algunos recursos para
proporcionar funcionalidad a la etiqueta, como conexiones de eventos o
tablas. Para prevenir pérdidas de memoria, es una buena idea limpiar estos
(desconectar, establecer en `nil`, etc.) cuando ya no sean necesarios para una etiqueta.

Instance:RemoveTag

Restablece una propiedad a su valor predeterminado. Por ejemplo, llamar a
`ResetPropertyToDefault("Rotation")` en un `Class.TextLabel` es equivalente
a establecer su `Class.TextLabel.Rotation|Rotation` a `0` (el valor
defecto de la propiedad). Este método puede ser utilizado para asegurar que el
estilo sobrescriba este valor predeterminado de la propiedad.

Instance:ResetPropertyToDefault

Restablece una propiedad a su valor predeterminado.

Este método establece el atributo con el nombre dado al valor dado. Si
el valor dado es `nil`, el atributo será eliminado, ya que `nil` es
devuelto por defecto.

Por ejemplo, el siguiente fragmento de código establece el atributo
`InitialPosition` de la instancia a `Datatype.Vector3|Vector3.new(0, 10, 0)`:

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

local part = Workspace.Part
part:SetAttribute("InitialPosition", Vector3.new(0, 10, 0))
```

##### Limitaciones

Requisitos y restricciones de nombres:

- Los nombres solo deben usar caracteres alfanuméricos.
  - También puedes incluir puntos, guiones, barras y guiones bajos.
- No se permiten espacios ni símbolos únicos (como @, ~, !) .
- Las cadenas deben tener 100 caracteres o menos.
- No se permiten nombres que comiencen con **RBX** a menos que el llamador sea un
  script central de Roblox (reservado para Roblox).

Al intentar establecer un atributo a un tipo no soportado, se lanzará
un error.

##### Ver También

- `Class.Instance:GetAttribute()` que devuelve el valor que ha sido
  asignado al nombre de atributo dado.
- `Class.Instance:GetAttributes()` que devuelve un diccionario de pares clave-valor
  para cada uno de los atributos de la instancia.

Instance:SetAttribute

Establece el atributo con el nombre dado al valor dado.

Instance

`Instance` es la clase base para todas las clases en la jerarquía de clases de Roblox
que pueden ser parte del árbol `Class.DataModel`.

GuiBase2d

Resumen

Propiedades

Métodos

Eventos

Propiedades

Métodos

Eventos

En esta página