`Class.BillboardGui` es un contenedor para objetos de interfaz de usuario que aparecen en el espacio 3D
pero siempre enfrentan a la cámara. La posición del contenedor es relativa al padre
`Class.BasePart` o `Class.Attachment` (o al
`Class.BillboardGui.Adornee|Adornee`). Para `Class.BasePart|BaseParts`, se
utiliza la propiedad `Class.BasePart.Position|Position`, mientras que para
`Class.Attachment|Attachments`, se utiliza la propiedad
`Class.Attachment.WorldPosition|WorldPosition`.

<img src="/assets/ui/in-experience/BillboardGui-Diagram.jpg" width="800" alt="BillboardGui con un TextLabel que describe la consola de pantalla sobre la que flota." />

La propiedad `Class.BillboardGui.Size|Size` de un cartel funciona ligeramente
diferente a `Class.GuiObject.Size`. Mientras que los componentes de **offset** funcionan
igualmente, los componentes de **escala** se utilizan como tamaños de studs en el espacio 3D.

Al crear un `Class.BillboardGui` escalado por tamaño que contiene un
`Class.TextLabel`, es útil activar la propiedad `Class.TextLabel.TextScaled|TextScaled` de la etiqueta para que su texto se escale junto
con el lienzo del cartel a medida que cambia la distancia de la cámara.

Nota que los elementos de UI interactivos como `Class.ImageButton|ImageButtons` y
`Class.TextButton|TextButtons` dentro de un `Class.BillboardGui` solo recibirán
entrada del usuario si están parentados a `Class.PlayerGui`, típicamente al
colocar el `Class.BillboardGui` dentro de `Class.StarterGui`. La propiedad
`Class.BillboardGui.Adornee|Adornee` se puede utilizar para apuntar a una parte o
adjunto en el mundo 3D mientras que el `Class.BillboardGui` en sí se mantiene en
`Class.PlayerGui`.

Consulta [In-Experience UI](/ui/in-experience-containers#billboard-ui)
para una guía sobre cómo trabajar con los contenedores `Class.BillboardGui`.

##### Comportamiento de Caché

Para ayudar a mejorar el rendimiento, la apariencia de un `Class.BillboardGui` se
cacha hasta que ocurra uno de los siguientes eventos, después de lo cual su apariencia será
recalculada en el siguiente fotograma de renderizado.

- Se añade o se elimina un descendiente del `Class.BillboardGui`.
- Cambia una propiedad de un descendiente del `Class.BillboardGui`.
- Cambia una propiedad del propio `Class.BillboardGui`.


BillboardGui

Controla si los descendientes recibirán eventos de entrada. Si el
`Class.BillboardGui` contiene un `Class.GuiButton`, ese botón se volverá
clicable solo si `Class.BillboardGui.Active|Active` está establecido en `true` en
ambos, el `Class.BillboardGui` **y** el botón.

Nota que los elementos de UI interactivos como `Class.ImageButton|ImageButtons`
y `Class.TextButton|TextButtons` dentro de un `Class.BillboardGui` solo
recibirán entrada del usuario si están parentados a `Class.PlayerGui`,
típicamente al colocar el `Class.BillboardGui` dentro de `Class.StarterGui`.
La propiedad `Class.BillboardGui.Adornee|Adornee` se puede utilizar para apuntar a una
parte o adjunto en el mundo 3D mientras que el `Class.BillboardGui` en sí
permanecen en el `Class.PlayerGui`.


BillboardGui.Active

Controla si los descendientes recibirán eventos de entrada.


Establece el `Class.BasePart` o `Class.Attachment` objetivo al que el
`Class.BillboardGui` está posicionado en relación, anulando la parte
padre o adjunta.


BillboardGui.Adornee

Establece la parte o el adjunto objetivo al que el `Class.BillboardGui` está
posicionado en relación.


Esta propiedad determina si el `Class.BillboardGui` siempre
renderiza por encima de otros objetos 3D.

Cuando se establece en `false` (valor predeterminado), el `Class.BillboardGui` renderiza como otros
contenidos 3D y es ocluido por otros objetos 3D. Cuando se establece en `true`, el
`Class.BillboardGui` siempre renderiza por encima del contenido 3D y la
apariencia cambia significativamente:

- Los colores coinciden con cómo aparecen dentro de un `Class.ScreenGui`.
- El texto puede aparecer más nítido en dispositivos de alta DPI.
- `Class.BillboardGui.LightInfluence|LightInfluence` se trata como si
  fuera `0`.
- `Class.BillboardGui.Brightness|Brightness` no tiene efecto.


BillboardGui.AlwaysOnTop

Determina si el `Class.BillboardGui` siempre se renderizará por encima
 de otros objetos 3D.


Esta propiedad determina el factor por el cual la luz del contenedor `Class.BillboardGui`
es escalada cuando
`Class.BillboardGui.LightInfluence|LightInfluence` es `0`. Por defecto,
esta propiedad es `1` y se puede establecer en cualquier número entre `0` y `1000`.
Al modificar esta propiedad, el brillo aparente de un
`Class.BillboardGui` puede ser mejorado para que coincida con su entorno. Por
ejemplo, un cartel de video puede ser iluminado en una habitación oscura al
incrementar `Class.BillboardGui.Brightness|Brightness` a `10`.

Nota que `Class.BillboardGui.Brightness|Brightness` es inaccesible en
Studio y no tiene efecto cuando `Class.BillboardGui.LightInfluence|LightInfluence` es `1` o
`Class.BillboardGui.AlwaysOnTop|AlwaysOnTop` es `true`.


BillboardGui.Brightness

Determina el factor por el cual la luz del contenedor `Class.BillboardGui`
es escalada cuando `Class.BillboardGui.LightInfluence|LightInfluence` es `0`.


Cuando se establece en `true` (valor predeterminado), las porciones de `Class.GuiObject|GuiObjects`
que caen fuera de los bordes del lienzo `Class.BillboardGui` no serán
dibujadas.

Incluso cuando esta propiedad es `false`, los `Class.GuiObject|GuiObjects` que están
**completamente** fuera del lienzo no se renderizarán.


BillboardGui.ClipsDescendants

Si las porciones de `Class.GuiObject|GuiObjects` que caen fuera de los
bordes del lienzo `Class.BillboardGui` serán dibujadas.


La distancia actual en studs que el `Class.BillboardGui` está del
cámara del jugador. Un evento de cambio no se dispara para esta propiedad a menos que
`Class.BillboardGui.DistanceStep|DistanceStep` sea mayor que `0`.


BillboardGui.CurrentDistance

La distancia actual en studs que el `Class.BillboardGui` está del
cámara del jugador.


Determina la distancia en studs a la cual el `Class.BillboardGui` se detendrá
escalando más grande en relación a la cámara actual del jugador, con un
valor predeterminado de `0`. Si la
`Class.BillboardGui.CurrentDistance|CurrentDistance` de el
`Class.BillboardGui` está por debajo de este valor, no se escalará más grande
que lo que haría a esta distancia.


BillboardGui.DistanceLowerLimit

Determina la distancia en studs a la cual el `Class.BillboardGui` se detendrá
escalando más grande.


Determina los incrementos y decrementos de tamaño `Class.BillboardGui.CurrentDistance|CurrentDistance`
en studs a medida que la cámara del jugador se acerca y se aleja del `Class.BillboardGui`. La propiedad tiene un valor predeterminado de `0`.


BillboardGui.DistanceStep

Determina los incrementos y decrementos de tamaño `Class.BillboardGui.CurrentDistance|CurrentDistance`
en studs a medida que la cámara del jugador se acerca y se aleja del `Class.BillboardGui`.


Determina la distancia en studs a la cual el `Class.BillboardGui` se detendrá
escalando más pequeño en relación a la cámara actual del jugador. Si
the `Class.BillboardGui.CurrentDistance|CurrentDistance` de el
`Class.BillboardGui` está por encima de este valor, no se escalará más pequeño
que lo que haría a esta distancia.

Esta propiedad se ignora si el valor es menor que `0`. El valor predeterminado es
`-1`, lo que significa que la propiedad es ignorada por defecto.


BillboardGui.DistanceUpperLimit

Determina la distancia en studs a la cual el `Class.BillboardGui` se detendrá
escalando más pequeño.


Esta propiedad determina cómo el `Class.BillboardGui` se compensa desde su
`Class.BillboardGui.Adornee|Adornee`, en relación a la orientación de la `Class.Camera`
, en unidades de la mitad de las dimensiones de la caja de límites alineada a la cámara del modelo.

Consulta también `Class.BillboardGui.StudsOffset|StudsOffset`, que funciona
similarmente pero utiliza unidades de studs, o
`Class.BillboardGui.ExtentsOffsetWorldSpace|ExtentsOffsetWorldSpace`, que
funciona de manera similar excepto que la orientación del desplazamiento es respecto a los
ejes globales.


BillboardGui.ExtentsOffset

Determina cómo el `Class.BillboardGui` se compensa desde su
`Class.BillboardGui.Adornee|Adornee`, en relación a la orientación de la `Class.Camera`
, en unidades de la mitad de las dimensiones de la caja de límites alineada a la cámara del modelo.


Esta propiedad determina cómo el `Class.BillboardGui` se compensa desde su
`Class.BillboardGui.Adornee|Adornee`, en relación a los ejes globales, en
unidades de la mitad de las dimensiones de la caja de límites alineada al modelo.

Consulta también `Class.BillboardGui.StudsOffset|StudsOffset`, que funciona
similarmente pero utiliza unidades de studs, o
`Class.BillboardGui.ExtentsOffset|ExtentsOffset`, que funciona de manera similar
excepto que la orientación del desplazamiento es respecto a la `Class.Camera`.


BillboardGui.ExtentsOffsetWorldSpace

Determina cómo el `Class.BillboardGui` se compensa desde su
`Class.BillboardGui.Adornee|Adornee`, en relación a los ejes globales, en
unidades de la mitad de las dimensiones de la caja de límites alineada al modelo.


Controla cuánto influye la iluminación ambiental en el `Class.BillboardGui`, en un rango de `0` a `1`. Establecer esto en `1` significa que
la iluminación circundante tiene control total sobre la apariencia, mientras que
establecerlo en `0` significa que la iluminación no tiene efecto.


BillboardGui.LightInfluence

Controla cuánto influye la iluminación ambiental en el `Class.BillboardGui`.


Esta propiedad controla qué tan lejos de la cámara se mostrará el
`Class.BillboardGui` antes de que deje de renderizar. Un valor de `0` o `inf`
(valor predeterminado) significa que no hay límite y se renderizará infinitamente lejos.

Para `Class.BillboardGui|BillboardGuis` que aparecen al aire libre, se
recomienda que `Class.BillboardGui.MaxDistance|MaxDistance` sea lo suficientemente alta
para garantizar que la UI del contenedor sea suficientemente pequeña en la
pantalla cuando aparece o desaparece, minimizando el efecto de
aparición/desaparición repentino.


BillboardGui.MaxDistance

Controla qué tan lejos puede estar el `Class.BillboardGui` antes de que
deje de renderizar.


Usado por scripts para ocultar el `Class.BillboardGui` de un jugador específico.

Para ocultar un `Class.BillboardGui` de más de un jugador, colócalo en
`Class.StarterGui` y usa un script para establecer la
`Class.BillboardGui.Enabled|Enabled` propiedad de acuerdo a si el
`Class.Players.LocalPlayer|LocalPlayer` debería poder verlo. La
`Class.BillboardGui.Adornee|Adornee` propiedad se puede usar para adjuntar el
`Class.BillboardGui` a un `Class.BasePart` o `Class.Attachment` en el
`Class.Workspace`, en lugar de parentarlo.


BillboardGui.PlayerToHideFrom

Usado por scripts para ocultar el `Class.BillboardGui` de un jugador específico.


Controla el tamaño que tendrá el `Class.BillboardGui` en la pantalla.
A diferencia de `Class.GuiObject.Size`, los
componentes de [escala](/ui/position-and-size#size) de esta propiedad
establecen el tamaño de los studs del cartel en el espacio 3D.


BillboardGui.Size

Controla el tamaño que tendrá el `Class.BillboardGui` en la pantalla.


Un desplazamiento 2D en unidades relativas al tamaño que actúa como un punto de anclaje. Esto
puede ser utilizado de manera similar a la propiedad `Class.GuiObject.AnchorPoint`, pero
los valores son diferentes.

<table size="small">
<thead>
<th>Desplazamiento de Tamaño</th>
<th>Explicación</th>
</thead>
<tbody>
<tr>
<td><code>0, 0</code></td>
<td>El valor predeterminado en el que la UI estará anclada en su centro.</td>
</tr>
<tr>
<td><code>0.5, 0.5</code></td>
<td>La UI estará anclada en la esquina inferior izquierda.</td>
</tr>
<tr>
<td><code>0.5, -0.5</code></td>
<td>La UI estará anclada en la esquina superior izquierda.</td>
</tr>
<tr>
<td><code>-0.5, 0.5</code></td>
<td>La UI estará anclada en la esquina superior derecha.</td>
</tr>
<tr>
<td><code>-0.5, -0.5</code></td>
<td>La UI estará anclada en la esquina inferior derecha.</td>
</tr>
</tbody>
</table>

Consulta también `Class.BillboardGui.StudsOffset|StudsOffset`,
`Class.BillboardGui.StudsOffsetWorldSpace|StudsOffsetWorldSpace`,
`Class.BillboardGui.ExtentsOffset|ExtentsOffset`, y
`Class.BillboardGui.ExtentsOffsetWorldSpace|ExtentsOffsetWorldSpace`, que
son propiedades de desplazamiento que funcionan en el espacio 3D.


BillboardGui.SizeOffset

Un desplazamiento 2D en unidades relativas al tamaño que actúa como un punto de anclaje.


Esta propiedad determina cómo el `Class.BillboardGui` se compensa desde su
`Class.BillboardGui.Adornee|Adornee` en studs, en relación a la
orientación de la `Class.Camera`.

Consulta también `Class.BillboardGui.StudsOffsetWorldSpace|StudsOffsetWorldSpace`
que funciona de manera similar excepto que la orientación del desplazamiento es respecto a los
ejes globales.


BillboardGui.StudsOffset

Determina cómo el `Class.BillboardGui` se compensa desde su
`Class.BillboardGui.Adornee|Adornee` en studs, en relación a la
orientación de la `Class.Camera`.


Esta propiedad determina cómo el `Class.BillboardGui` se compensa desde su
`Class.BillboardGui.Adornee|Adornee` en studs, en relación a los ejes globales.

Consulta también `Class.BillboardGui.StudsOffset|StudsOffset`, que funciona
similarmente excepto que la orientación del desplazamiento es respecto a la `Class.Camera`.


BillboardGui.StudsOffsetWorldSpace

Determina cómo el `Class.BillboardGui` se compensa desde su
`Class.BillboardGui.Adornee|Adornee` en studs, en relación a los ejes globales.


Un contenedor para `Class.GuiObject|GuiObjects` que se renderiza en el espacio 3D enfrentando a
la cámara.


**LayerCollector** es la clase base de contenedores de UI 2D que renderizan
los descendientes de `Class.GuiObject`, como `Class.ScreenGui`.

Para mejorar el rendimiento, la apariencia de un `Class.LayerCollector` es
almacenada en caché hasta que ocurran uno de los siguientes eventos:

- Se añade o se quita un descendiente.
- Cambia una propiedad de un descendiente.
- Cambia una propiedad del propio `Class.LayerCollector`.

LayerCollector:GetLayoutNodeTree

LayerCollector

Alterna la visibilidad de este `Class.LayerCollector`. Cuando es `false`, los
contenidos de la UI no se renderizarán, no procesarán la entrada del usuario,
o se actualizarán en respuesta a cambios.

LayerCollector.Enabled

Alterna la visibilidad de este `Class.LayerCollector`.

Cuando se establece a `false` y este `Class.LayerCollector` es un hijo directo de
`Class.StarterGui`, solo se clonará en el `Class.PlayerGui` de cada jugador una vez y
no se eliminará cuando el personaje del jugador reaparezca.

Cuando se establece a `true` (predeterminado), o si este `Class.LayerCollector` es
un descendiente **indirecto** de `Class.StarterGui`, se clonará en el `Class.PlayerGui`
de cada jugador cuando su personaje reaparezca, y se eliminará a sí mismo cuando el
personaje del jugador reaparezca nuevamente.

LayerCollector.ResetOnSpawn

Determina si el `Class.LayerCollector` se restablece (se elimina a sí mismo y
se vuelve a clonar en el `Class.PlayerGui` del jugador) cada vez que el
personaje del jugador reaparece.

Controla cómo se comporta `Class.GuiObject.ZIndex` en todos los descendientes de este
`Class.LayerCollector`.

Con `Enum.ZIndexBehavior.Sibling` (predeterminado), los hijos siempre se renderizan sobre
t sus padres, y el `Class.GuiObject.ZIndex|ZIndex` se utiliza para decidir
el orden en el que los hijos de un solo objeto UI se renderizarán entre sí.

`Enum.ZIndexBehavior.Global` ordena todos los descendientes de acuerdo al
`Class.GuiObject.ZIndex|ZIndex`, y luego rompe los empates utilizando el
orden de jerarquía. Como resultado, los descendientes de un `Class.GuiObject` deben tener un
valor de `Class.GuiObject.ZIndex|ZIndex` que sea al menos tan alto como el
padre, o se renderizarán por debajo de su padre.


LayerCollector.ZIndexBehavior

Controla cómo se comporta `Class.GuiObject.ZIndex` en todos los descendientes de este
`Class.LayerCollector`.


La clase base de contenedores de UI 2D que renderizan `Class.GuiObject|GuiObjects`
en capas.

`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
antecesores, informándoles que la selección ha
cambiado/entrado/salido a un `Class.GuiObject` en su árbol de descendientes.


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 pixeles. Esto representa la posición de píxeles real en la que se renderiza un elemento
como resultado de los tamaños y posiciones de sus antecesores. Nota que
`Class.GuiBase2d.AbsolutePosition|AbsolutePosition` siempre representa la
esquina superior izquierda del elemento `Class.GuiBase2d`.

Si el `Class.GuiBase2d` está en un `Class.ScreenGui`, la
propiedad `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` utiliza el
sistema de coordenadas del viewport de `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
pixeles.


`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 **verificaciones 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
pixeles.

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


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 vuelven a
traducir automáticamente después de que se cargue la tabla en la nube 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 la tabla de localización
`Class.LocalizationTable.Root` apunta a este objeto, o a un antecesor de este
objeto. `Class.LocalizationTable|LocalizationTables` con su
propiedad `Class.LocalizationTable.Root` apuntando a una instancia localizará
todos los `Class.TextLabel.TextButton` que son descendientes de la raíz
instancia.


GuiBase2d.Localize

Se establece automáticamente en verdadero cuando la tabla de localización
`Class.LocalizationTable.Root` apunta a este objeto, o a un antecesor 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 establecido en `true` en el
`Class.GuiBase2d` y sus antecesores para que la localización automatizada se
aplique.

Puedes establecer esto para referenciar una `Class.LocalizationTable` en cualquier lugar del
`Class.DataModel`. El objeto `Class.GuiBase2d` y todos sus hijos
intentarán usar esa `Class.LocalizationTable` específica y sus antecesores
para la sustitución automática de texto antes de usar las tablas bajo
`Class.LocalizationService` en un orden indefinido y la tabla en la nube.

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
se utiliza la `Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable`
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 hacia abajo.


GuiBase2d.SelectionBehaviorDown

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


GuiBase2d.SelectionBehaviorLeft

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


GuiBase2d.SelectionBehaviorRight

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


GuiBase2d.SelectionBehaviorUp

Permite la personalización de cómo la selección del gamepad puede moverse entre
los 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, un ajuste 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
fuera si no encuentra un botón adecuado. Alternativamente, un ajuste de
`Enum.SelectionBehavior.Stop` significa que la selección del gamepad solo mira dentro
del grupo de selección y no se mueve fuera del grupo desde 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 `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 de la jerarquía de clases de Roblox
que pueden ser parte del árbol de `Class.DataModel`.

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

Demuestra cómo detectar cambios en la ascendencia de una instancia al conectarse al
`Class.Instance.AncestryChanged` evento.

El Parent 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 esta instancia es reparentada o cuando cualquiera de sus
ancestros es reparentado.

Puedes usar este evento para rastrear la eliminación de una instancia en el
Studio, como la eliminación manual en el Explorador o a través de un
plugin. Si necesitas detectar cuándo una instancia es destruida usando
`Class.Instance:Destroy()`, usa en su lugar el evento
`Class.Instance.Destroying`.

Instance.AncestryChanged

child

La instancia cuya propiedad `Class.Instance.Parent|Parent` ha cambiado,
que puede ser esta instancia o un ancestro más distante, **no**
es necesariamente la instancia a la que el controlador está conectado.

parent

Se activa cuando la propiedad `Class.Instance.Parent` de este 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 que se active cada vez que cambia uno de los
atributos de la parte:

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

Instance.AttributeChanged

attribute

El nombre del atributo que ha sido cambiado.

Se activa cada vez que se cambia un atributo en la `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 es parentado a esta `Class.Instance`.

Nota, 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 este objeto. Esto se debe a que el objeto y sus
descendientes no se garantiza que se repliquen desde el 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)
```
Nota, 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

La `Class.Instance` que ha sido añadida.

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

Instance.childAdded

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 se cambia de esta
`Class.Instance` a algo diferente de esta `Class.Instance`. Nota, 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 a `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

La `Class.Instance` que ha sido eliminada.

Se activa después de que un hijo es 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 se añade un descendiente a la `Class.Instance`.

Al activarse para cada descendiente, parentar un objeto a la
`Class.Instance` activará el evento para este objeto y todos sus
descendientes individualmente.

Si solo te preocupas por 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 se añade un descendiente 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 padre de la `Class.Instance`
cambie de forma 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 al llamar a
ese método en un descendiente del padre, este evento se activará.

Dado que este evento se activa **antes** de la eliminación del descendiente,
el padre del descendiente no cambiará en el momento de la activación de
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 activará primero con el
descendiente, seguido por sus descendientes.

#### Advertencia

Este evento se activa con el objeto descendiente que se está eliminando.
Intentar establecer el `Class.Instance.Parent|Parent` del descendiente en
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 el padre fue manipulado, 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

La `Class.Instance` que se está eliminando.

Se activa inmediatamente antes de que se elimine un descendiente de la `Class.Instance`.

Este ejemplo demuestra cómo, al usar el comportamiento de señal Inmediata, una
Instancia que está siendo destruida permanece en su lugar hasta que la función conectada se detiene.


Este ejemplo demuestra cómo, al usar el comportamiento de señal diferida, una Instancia
se destruye antes de que se dispare la señal.


La `Class.Instance` nunca se eliminará de la memoria mientras una función conectada
la esté utilizando. Sin embargo, si la función se bloquea en algún momento,
la `Class.Instance` y sus descendientes serán parentados a `nil`.

Si la propiedad `Class.Workspace.SignalBehavior` está establecida en
`Enum.SignalBehavior.Immediate`, este evento se activa inmediatamente antes del
`Class.Instance` o de uno de sus ancestros es destruido 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, que estará después de que el `Class.Instance` o uno de
sus ancestros sean destruidos con `Class.Instance:Destroy()`.

Con el comportamiento de `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 al callback (lo que significa
que no se ejecutará).

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

Instance.Destroying

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

Este evento se activa cada vez que se cambia 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("Las propiedades de estilo han cambiado")
end

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

Instance.StyledPropertiesChanged

Se activa cada vez que se cambia cualquier propiedad de estilo en la instancia,
incluyendo cuando una propiedad se establece en `nil`.

Este método aplica una etiqueta a la instancia, sin efecto si la etiqueta ya
ha sido aplicada. Agregar una etiqueta con éxito generará 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 se eliminarán si el
  servidor más tarde añade o elimina una etiqueta en esa instancia porque el servidor
  replica todas las etiquetas juntas y sobrescribe las etiquetas anteriores.

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

Instance:AddTag

La función de los hijos devuelve un array de los hijos del objeto.

Instance:children

Devuelve un array de los hijos del objeto.

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

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

-- Agregar 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 ya sea
`Class.Instance:GetChildren()` o `Class.Instance:GetDescendants()` para
recorrer esos hijos/descendientes y seleccionar qué destruir. Por
ejemplo, el siguiente extracto de código destruirá todos
`Class.BasePart|BaseParts` descendientes 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,
ignorando 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`. Ten en cuenta que si la instancia misma tiene
`Class.Instance.Archivable|Archivable` establecida en `false`, este método devolverá
`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 original:

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

Instance:Clone

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

Instance:clone

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

Esta función es la manera correcta de eliminar 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 manera correcta de eliminar
objetos que ya no son necesarios.

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

Como mejor 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 = "Hola, mundo"
part:Destroy()
-- No hagas esto:
print(part.Name)  --> "Hola, mundo"
-- Haz esto para prevenir que la línea anterior funcione:
part = nil
```
Una vez que un `Class.Instance` ha sido destruido por este método, no puede ser
reutilizado 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` en `nil`, bloquea la
propiedad `Class.Instance.Parent`, desconecta todas las conexiones, y llama a
`Destroy()` en todos los hijos.

Instance:destroy

Devuelve el primer ancestro del `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 ancestro coincidente, devuelve `nil`.

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

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

Instance:FindFirstAncestor

name

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

Devuelve el primer ancestro del `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 ancestro 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 usa el método `Class.Object:IsA()` en su lugar para respetar la
herencia de clases.

Instance:FindFirstAncestorOfClass

className

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

Devuelve el primer ancestro del `Class.Instance` para quien
`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 ancestro 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 fragmento de código devolverá el primer
ancestro `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 ancestro del `Class.Instance` para quien
`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 del `Class.Instance` con el nombre dado, o
`nil` si no existe tal hijo. Si el argumento opcional `recursive` es
`true`, este método busca todos los descendientes en lugar de solo los
hijos inmediatos del `Class.Instance`.

#### Verificando la Existencia de un Objeto

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

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

-- La siguiente línea da error si la parte no existe en el espacio de trabajo
Workspace.Part.Transparency = 0.5
```
Un enfoque mejor es usar `FindFirstChild()` para primero comprobar si `Part`,
luego usar una instrucció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
```

#### Encontrar un Hijo cuyo Nombre Coincida con una Propiedad

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

En el siguiente ejemplo, se añade 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 hija
`Class.Folder`. Un beneficio de usar
`Class.Instance:FindFirstChild()|FindFirstChild()` es que la
introducción de nuevas propiedades no pone en riesgo 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()` toma aproximadamente un 20% más de
tiempo que usar el operador punto y casi 8 veces más que simplemente guardar un
referencia a un objeto. Por lo tanto, debes evitar llamarlo en
código dependiente del rendimiento, como en bucles ajustados 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
dado nombre se convierte disponible.

Instance:FindFirstChild

recursive

Si la búsqueda debe ser realizada de forma recursiva.

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

Instance:findFirstChild

Devuelve el primer hijo del `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 del `Class.Instance` para quien
`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 recursivo es verdadero, este método busca todos los descendientes en lugar
de solo los hijos inmediatos del `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 fragmento 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 busquen un hijo por nombre, deben usar
`Class.Instance:FindFirstChild()` en su lugar.

Instance:FindFirstChildWhichIsA

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 se puede usar. 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`, se devuelve el `Class.Actor` mismo.
De lo contrario, se devuelve su ancestro más cercano `Class.Actor`. Si no
hay ancestro que sea un `Class.Actor`, el resultado es `nil`.

Instance:GetActor

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

Instance

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

/reference/engine/classes/BillboardGui.yaml