`Class.GuiObject` es una clase abstracta (mucho como `Class.BasePart` ) para un objeto de interfaz de usuario 2D.Define todas las propiedades relacionadas con la visualización de un objeto de interfaz gráfica de usuario (Interfaz gráfica (o GUI)), como `Class.GuiObject.Size|Size` y `Class.GuiObject.Position|Position`.También tiene algunas propiedades útiles de solo lectura como `Class.GuiObject.AbsolutePosition|AbsolutePosition` , `Class.GuiObject.AbsoluteSize|AbsoluteSize` y `Class.GuiObject.AbsoluteRotation|AbsoluteRotation` .

  Para manipular el diseño de objetos GUI de manera especial, puedes usar una estructura de diseño como [lista/flex](/ui/list-flex-layouts) o [cuadrícula](/ui/grid-table-layouts) , y puedes estilarlos más allá de sus propiedades principales a través de [modificadores de apariencia](/ui/appearance-modifiers) .

  Aunque es posible detectar eventos de botones de ratón en cualquier objeto GUI usando `Class.GuiObject.InputBegan|InputBegan` y `Class.GuiObject.InputEnded|InputEnded`, solo `Class.ImageButton` y `Class.TextButton` tienen eventos convenientes dedicados como `Class.TextButton.Activated|Activated` para detectar clics/presiones.

The below example assumes it's within a GuiObject such as a `TextButton`, and
that the `Class.GuiObject.Draggable` property is set to true. It will print
the UDim2 of where the player started dragging the object from.

Este evento se activa cuando un jugador comienza a arrastrar el objeto.

  Vea también `Class.GuiObject.DragStopped` .

GuiObject.DragBegin

initialPosition

Un valor de `Datatype.UDim2` de la posición del `Class.GuiObject` antes de que comenzara cualquier operación de arrastre.

Se desfuega cuando un jugador comienza a arrastrar el objeto.

El ejemplo a continuación asume que está dentro de un GuiObject como un `TextButton` , y que la propiedad `Class.GuiObject.Draggable` está configurada como verdadera.Imprimirá el X y el Y de donde el jugador dejó de arrastrar la interfaz gráfica.Por ejemplo, si el jugador dejara de arrastrar el objeto en 189, 180 a continuación se imprimiría El jugador dejó de arrastrar el objeto GuiObject en (189, 180)

Este evento se activa cuando un jugador deja de arrastrar el objeto.

  Vea también `Class.GuiObject.DragBegin` .

GuiObject.DragStopped

La ubicación de la pantalla de **X** del ratónen píxeles, relativa a la esquina superior izquierda de la pantalla.

La ubicación de la pantalla de la ratón **Y** en píxeles, relativa a la esquina superior izquierda de la pantalla.

Se desfuega cuando un jugador deja de arrastrar el objeto.

The following example demonstrates one of many usage examples of handling user
input from InputBegan depending on its type.

In order for this to work as expected, it must be placed in a `LocalScript`
and a child of _gui_.

Este evento se activa cuando un usuario comienza a interactuar con el `Class.GuiObject` a través de un dispositivo de interfaz humana-ordenador (botón del ratón hacia abajo, toque de inicio, botón de teclado hacia abajo, etc.).

  El `Class.UserInputService` tiene un evento de nombre similar que no está restringido a un elemento de interfaz de usuario específico: `Class.UserInputService.InputBegan` .

  Este evento siempre se disparará independientemente del estado del juego.

  Vea también `Class.GuiObject.InputEnded` y `Class.GuiObject.InputChanged` .

GuiObject.InputBegan

input

Un `Class.InputObject` , que contiene datos útiles para consultar la entrada del usuario como el `Enum.UserInputType|type of input` , `Enum.UserInputState|state of input` y `Class.InputObject.Position|screen coordinates of the input` .

Despedido cuando un usuario comienza a interactuar a través de un dispositivo de interfaz humana-computadora (botón del mouse hacia abajo, toque de inicio, botón de teclado hacia abajo, etc.).

The following example demonstrates one of many usage examples of handling user
input from InputChanged depending on its type.

In order for this to work as expected, it must be placed in a `LocalScript`
and a child of _gui_.

Este evento se activa cuando un usuario cambia la forma en que interactúa a través de un dispositivo de interfaz humana-ordenador (botón del ratón hacia abajo, toque de inicio, botón de teclado hacia abajo, etc.).

  El `Class.UserInputService` tiene un evento de nombre similar que no está restringido a un elemento de interfaz de usuario específico: `Class.UserInputService.InputChanged` .

  Este evento siempre se disparará independientemente del estado del juego.

  Vea también `Class.GuiObject.InputBegan` y `Class.GuiObject.InputEnded` .

GuiObject.InputChanged

Despedido cuando un usuario cambia la forma en que interactúa a través de un dispositivo de interfaz humana-computadora (botón del mouse hacia abajo, toque de inicio, botón de teclado hacia abajo, etc.).

The following example demonstrates one of many usage examples of handling user
input from InputEnded depending on its type.

In order for this to work as expected, it must be placed in a `LocalScript`
and a child of _gui_.

El evento InputEnded se activa cuando un usuario deja de interactuar a través de un dispositivo de interfaz humana-ordenador (botón del ratón hacia abajo, toque de inicio, botón de teclado hacia abajo, etc.).

  El `Class.UserInputService` tiene un evento de nombre similar que no está restringido a un elemento de interfaz de usuario específico: `Class.UserInputService.InputEnded` .

  Este evento siempre se disparará independientemente del estado del juego.

  Vea también `Class.GuiObject.InputBegan` y `Class.GuiObject.InputChanged` .

GuiObject.InputEnded

Un `Class.InputObject` , que contiene datos útiles para consultar la entrada del usuario como el `Enum.UserInputType` , `Enum.UserInputState` y `Class.InputObject.Position` .

Despedido cuando un usuario deja de interactuar a través de un dispositivo de interfaz humana-ordenador (botón del ratón hacia abajo, toque de inicio, botón de teclado hacia abajo, etc.).

The following example prints the mouse location, in pixels, when it enters GUI
element.

El evento MouseEnter se activa cuando un usuario mueve el mouse a un elemento `Class.GuiObject`.

  Por favor, no confíe en los argumentos `x` y `y` pasados por este evento como una forma infalible de determinar dónde está el mouse del usuario cuando entra en una Interfaz gráfica (o GUI).Estas coordenadas pueden variar incluso cuando el ratón ingresa a la interfaz gráfica a través del mismo borde - particularmente cuando el ratón ingresa al elemento rápidamente.Esto se debe al hecho de que las coordenadas indican la posición del mouse cuando se activa el evento en lugar del momento exacto en que el mouse entra en la Interfaz gráfica (o GUI).

  Este evento se activa incluso cuando el elemento GUI se renderiza debajo de otro elemento.

  Si desea rastrear cuando el mouse de un usuario deja un elemento de interfaz gráfica, puede usar el evento `Class.GuiObject.MouseLeave`.

  ##### Ver también

  *   `Class.GuiObject.MouseLeave`
  *   `Class.GuiObject.MouseMoved`
  *   `Class.GuiObject.MouseWheelForward`
  *   `Class.GuiObject.MouseWheelBackward`

GuiObject.MouseEnter

La coordenada de la pantalla de la ratón **X** en píxeles, relativa a la esquina superior izquierda de la pantalla.

La coordenada de la pantalla del ratón **Y** en píxeles, relativa a la esquina superior izquierda de la pantalla.

Se activa cuando un usuario mueve el mouse a un elemento de interfaz gráfica.

El evento MouseLeave se activa cuando un usuario mueve el mouse fuera de un elemento `Class.GuiObject`.

  Por favor, no confíe en los argumentos `x` y `y` pasados por este evento como una forma infalible de determinar dónde está el mouse del usuario cuando sale de una Interfaz gráfica (o GUI).Estas coordenadas pueden variar incluso cuando el mouse abandona la interfaz gráfica a través del mismo borde - particularmente cuando el mouse abandona el elemento rápidamente.Esto se debe al hecho de que las coordenadas indican la posición del mouse cuando se activa el evento en lugar del momento exacto en que el mouse deja la Interfaz gráfica (o GUI).

  Este evento se activa incluso cuando el elemento GUI se renderiza debajo de otro elemento.

  ##### Ver también

  *   `Class.GuiObject.MouseEnter`
  *   `Class.GuiObject.MouseMoved`
  *   `Class.GuiObject.MouseWheelForward`
  *   `Class.GuiObject.MouseWheelBackward`

GuiObject.MouseLeave

Se activa cuando un usuario mueve el mouse fuera de un elemento de interfaz gráfica.

Se activa cada vez que un usuario mueve el mouse mientras está dentro de un elemento `Class.GuiObject` .Es similar a `Class.Mouse.Move` , que se activa independientemente de si el mouse del usuario está sobre un elemento de interfaz gráfica.

  Nota, este evento se activa cuando se actualiza la posición del ratón, por lo tanto, se activará repetidamente mientras se mueve.

  Los argumentos `x` y `y` indican las coordenadas de la pantalla actualizadas del mouse del usuario en píxeles.Estos pueden ser útiles para determinar la ubicación del ratónen la Interfaz gráfica (o GUI), la pantalla y el delta desde la posición anterior del ratónsi se está rastreando en una variable global.

  El código a continuación muestra cómo determinar el desplazamiento `Datatype.Vector2` del mouse del usuario relativo a un elemento de interfaz gráfica:

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

  local CustomScrollingFrame = script.Parent
  local SubFrame = CustomScrollingFrame:FindFirstChild("SubFrame")

  local mouse = Players.LocalPlayer:GetMouse()

  local function getPosition(X, Y)
  	local gui_X = CustomScrollingFrame.AbsolutePosition.X
  	local gui_Y = CustomScrollingFrame.AbsolutePosition.Y


  	local pos = Vector2.new(math.abs(X - gui_X), math.abs(Y - gui_Y - 36))
  	print(pos)
  end

  CustomScrollingFrame.MouseMoved:Connect(getPosition)
  ```

  Tenga en cuenta que este evento puede no disparar exactamente cuando el mouse del usuario ingresa o sale de un elemento de interfaz gráfica.Por lo tanto, los argumentos `x` y `y` pueden no coincidir perfectamente con las coordenadas de los bordes de la Interfaz gráfica (o GUI).

  ##### Ver también

  *   `Class.GuiObject.MouseEnter`
  *   `Class.GuiObject.MouseLeave`
  *   `Class.GuiObject.MouseWheelForward`
  *   `Class.GuiObject.MouseWheelBackward`

GuiObject.MouseMoved

Se activa cada vez que un usuario mueve el mouse mientras está dentro de un elemento de interfaz gráfica.

El evento WheelBackward se activa cuando un usuario desplaza la rueda del ratón hacia atrás cuando el ratón está sobre un elemento `Class.GuiObject`.Es similar a `Class.Mouse.WheelBackward` , que se activa independientemente de si el mouse del usuario está sobre un elemento de interfaz gráfica.

  Este evento se dispara simplemente como un indicador del movimiento hacia atrás de la rueda.Esto significa que los argumentos de coordenadas del ratón `x` y `y` no cambian como resultado de este evento.Estas coordenadas solo cambian cuando el mouse se mueve, lo que se puede rastrear por el evento `Class.GuiObject.MouseMoved`.

  ##### Ver también

  *   `Class.GuiObject.MouseEnter`
  *   `Class.GuiObject.MouseLeave`
  *   `Class.GuiObject.MouseMoved`
  *   `Class.GuiObject.MouseWheelForward`

GuiObject.MouseWheelBackward

Se activa cuando un usuario desplaza la rueda del ratón hacia atrás cuando el ratón está sobre un elemento de interfaz gráfica.

El evento WheelForward se activa cuando un usuario desplaza la rueda del ratón hacia adelante cuando el ratón está sobre un elemento `Class.GuiObject`.Es similar a `Class.Mouse.WheelForward` , que se activa independientemente de si el mouse del usuario está sobre un elemento de interfaz gráfica.

  Este evento se dispara simplemente como un indicador del movimiento hacia adelante de la rueda.Esto significa que los argumentos de coordenadas del ratón **X** y **Y** no cambian como resultado de este evento.Estas coordenadas solo cambian cuando el mouse se mueve, lo que se puede rastrear por el evento `Class.GuiObject.MouseMoved`.

  ##### Ver también

  *   `Class.GuiObject.MouseEnter`
  *   `Class.GuiObject.MouseLeave`
  *   `Class.GuiObject.MouseMoved`
  *   `Class.GuiObject.MouseWheelBackward`

GuiObject.MouseWheelForward

La coordenada **Y** del ratóndel usuario.

Se activa cuando un usuario desplaza la rueda del ratón hacia adelante cuando el ratón está sobre un elemento de interfaz gráfica.

The following example prints a message when the user selects the object with a
gamepad.

In order for this to work as expected, it must be placed in a `LocalScript`
and a child of _gui_.

Este evento se activa cuando el seleccionador de Gamepad comienza a centrarse en el `Class.GuiObject`.

  Si quieres comprobar desde el Gamepad seleccionar dejar de enfocarse en el elemento GUI, puedes usar el evento `Class.GuiObject.SelectionLost`.

  Cuando una GUI gana el enfoque de selección, el valor de la propiedad `Class.GuiService.SelectedObject|SelectedObject` también cambia a la que gana la selección.Para determinar qué GUI obtuvo la selección, verifique el valor de esta propiedad.

GuiObject.SelectionGained

Se desfija cuando el GuiObject se está enfocando con el seleccionador de Gamepad.

The following example prints a message when the element has its focus lost on
a gamepad.

In order for this to work as expected, it must be placed in a `LocalScript`
and a child of _gui_.

Este evento se activa cuando el seleccionador de Gamepad deja de centrarse en el `Class.GuiObject`.

  Si quieres comprobar desde el Gamepad selecciona empieza a centrarse en el elemento de la interfaz gráfica, puedes usar el evento `Class.GuiObject.SelectionGained`.

  Cuando una GUI pierde el enfoque de selección, el valor de la propiedad `Class.GuiService.SelectionObject|SelectionObject` cambia a `nil` o al elemento de la interfaz que gana el enfoque de selección.Para determinar qué GUI obtuvo la selección, o si no se selecciona ninguna GUI, compruebe el valor de esta propiedad.

GuiObject.SelectionLost

Despedido cuando el seleccionador de Gamepad deja de centrarse en el GuiObject.

This code sample allows the player to manipulate the screen position of some
UI element, like a `Frame`, by holding down on the UI element for a brief
moment. Then, the player moves their finger and releases. During the gesture
the Frame is colored blue with a white outline.

Este evento se activa después de un breve momento cuando el jugador mantiene su dedo en el elemento de la interfaz de usuario usando un dispositivo que admite táctiles.Dispara con una tabla de `Datatype.Vector2` que describe las posiciones relativas de la pantalla de los dedos involucrados en el gesto.Además, dispara varias veces: `Enum.UserInputState.Begin` después de un breve retraso, `Enum.UserInputState.Change` si el jugador mueve el dedo durante el gesto, y finalmente `Enum.UserInputState.End` .El retraso es dependiente de la plataforma; en Studio es un poco más largo que un segundo.

  Dado que este evento solo requiere un dedo, este evento se puede simular en Studio usando el emulador y un ratón.

GuiObject.TouchLongPress

touchPositions

Un array de que describe las posiciones relativas de los dedos involucrados en el gesto.

state

Un `Enum.UserInputState` que describe el estado del gesto:

  *   Comience fuegos una vez al comienzo del gesto (después del breve retraso)
  *   Cambiar fuegos si el jugador mueve el dedo mientras presiona hacia abajo
  *   Apaga los fuegos una vez al final del gesto cuando sueltan su dedo.

Se enciende cuando el jugador comienza, continúa y detiene presionando largamente el elemento de la interfaz de usuario.

This code sample is meant to be placed in a `LocalScript` within an inner
`Frame` that is inside an outer `Frame`, or other `GuiObject`. It allows the
player to manipulate the position of the inner frame by moving their finger on
the outer frame.

Este evento se activa cuando el jugador mueve el dedo en el elemento de la interfaz de usuario usando un dispositivo habilitado para el tacto.Dispara poco antes de que `Class.GuiObject.TouchSwipe` dispararía, y no dispara con `Class.GuiObject.TouchTap`.Este evento es útil para permitir que el jugador manipule la posición de los elementos de la interfaz en la pantalla.

  Este evento se activa con una tabla de `Datatype.Vector2` que describe las posiciones relativas de la pantalla de los dedos involucrados en el gesto.Además, dispara varias veces: `Enum.UserInputState.Begin` después de un breve retraso, `Enum.UserInputState.Change` cuando el jugador mueve el dedo durante el gesto, y finalmente con `Enum.UserInputState.End` .

  Este evento no se puede simular en Studio usando el emulador y un ratón; debe tener un dispositivo real habilitado para tocar para dispararlo.

GuiObject.TouchPan

Un array de Luau de `Datatype.Vector2` objetos, cada uno que indica la posición de todos los dedos involucrados en el gesto.

totalTranslation

Indica hasta dónde se ha movido el gesto de la sartén desde su punto de partida.

velocity

Indica con qué rapidez se está realizando el gesto en cada dimensión.

Indica el `Enum.UserInputState` de la gestión.

Se activa cuando el jugador mueve el dedo en el elemento de la interfaz de usuario.

This code sample is meant for a `LocalScript` within an inner `Frame` that is
inside an outer `Frame`, or other `GuiObject`. It allows the player to scale
the inner frame by performing a `Class.GuiObject.TouchPinch` gesture on the
outer frame.

Este evento se activa cuando el jugador usa dos dedos para hacer un gesto de pinzamiento o de tracción en el elemento de la interfaz de usuario usando un dispositivo habilitado para el tacto.Un **pinchazo** ocurre cuando dos o más dedos se mueven más cerca el uno del otro, y un **empuje** ocurre cuando se separan.Este evento se activa en conjunción con `Class.GuiObject.TouchPan` .Este evento es útil para permitir que el jugador manipule el tamaño (tamaño) de los elementos de la interfaz de usuario en la pantalla, y se usa más a menudo para funciones de zoom.

  Este evento se activa con una tabla de `Datatype.Vector2` que describe las posiciones relativas de la pantalla de los dedos involucrados en el gesto.Además, dispara varias veces: `Enum.UserInputState.Begin` después de un breve retraso, `Enum.UserInputState.Change` cuando el jugador mueve un dedo durante el gesto, y finalmente con `Enum.UserInputState.End` .Se debe tener en cuenta que la escala debe usarse **multiplicativamente** .

  Dado que este evento requiere al menos dos dedos, no es posible simularlo en Studio usando el emulador y un ratón; debe tener un dispositivo real habilitado para tocar.

GuiObject.TouchPinch

Un array de Luau de `Datatype.Vector2` objetos, cada uno que indica la posición de todos los dedos involucrados en el gesto de presión.

scale

Un flotante que indica la diferencia desde el comienzo del gesto de pellizco.

Un flotante que indica qué tan rápido está ocurriendo el gesto de agarre.

Se activa cuando el jugador realiza un gesto de pinzamiento o de tiro usando dos dedos en el elemento de la interfaz de usuario.

This code sample is meant for a `LocalScript` within an inner `Frame` that is
inside an outer `Frame`, or other `GuiObject`. It allows the player to rotate
the inner frame by performing a `Class.GuiObject.TouchRotate` gesture on the
outer frame.

Este evento se activa cuando el jugador usa dos dedos para hacer un gesto de pinzamiento o de tracción en el elemento de la interfaz de usuario usando un dispositivo habilitado para el tacto.La rotación ocurre cuando el ángulo de la línea entre dos dedos cambia.Este evento se activa en conjunción con `Class.GuiObject.TouchPan` .Este evento es útil para permitir que el jugador manipule la rotación de los elementos de la interfaz en la pantalla.

  Este evento se activa con una tabla de `Datatype.Vector2` que describe las posiciones relativas de la pantalla de los dedos involucrados en el gesto.Además, dispara varias veces: `Enum.UserInputState.Begin` después de un breve retraso, `Enum.UserInputState.Change` cuando el jugador mueve un dedo durante el gesto, y finalmente con `Enum.UserInputState.End` .

  Dado que este evento requiere al menos dos dedos, no es posible ser simulado en Studio usando el emulador y un ratón; debe tener un dispositivo real habilitado para tocar.

GuiObject.TouchRotate

rotation

Un flotante que indica cuánto ha girado la rotación desde el comienzo del gesto.

Un flotante que indica qué tan rápidamente se está realizando el gesto.

Se activa cuando el jugador realiza un gesto de rotación usando dos dedos en el elemento de la interfaz de usuario.

This code sample will cause a `Frame` (or other `GuiObject`) to bounce when a
swipe gesture is performed on a touch-enabled device (or Studio's emulator).
Horizontal swipes will change the hue of the
`Class.GuiObject.BackgroundColor3`, while vertical swipes will change the
saturation.

Este evento se activa cuando el jugador realiza un gesto de deslizamiento en el elemento de la interfaz de usuario usando un dispositivo habilitado para el tacto.Dispara con la dirección del gesto (Arriba, Abajo, Izquierda o Derecha) y el número de puntos de contacto involucrados en el gesto.Los gestos de deslizamiento se utilizan a menudo para cambiar las pestañas en las interfaces móviles.

  Dado que este evento solo requiere un dedo, se puede simular en Studio usando el emulador y un ratón.

GuiObject.TouchSwipe

swipeDirection

Un `Enum.SwipeDirection` que indica la dirección del gesto de deslizamiento (Arriba, Abajo, Izquierda o Derecha).

numberOfTouches

El número de puntos de contacto involucrados en el gesto (normalmente 1).

Se activa cuando el jugador realiza un gesto de deslizamiento en el elemento de la interfaz de usuario.

This code sample will toggle the `Class.GuiObject.BackgroundTransparency` of a
UI element, like a `Frame`, when it is tapped on a touch-enabled device.

Este evento se activa cuando el jugador realiza un gesto de toque en el elemento de la interfaz de usuario usando un dispositivo habilitado para tocar.Un toque es un rápido toque sin ningún movimiento involucrado (un toque más largo dispararía `Class.GuiObject.TouchLongPress` , y moverse durante el toque dispararía `Class.GuiObject.TouchPan` y/o `Class.GuiObject.TouchSwipe` ).Dispara con una tabla de `Datatype.Vector2` objetos que describen las posiciones relativas de los dedos involucrados en el gesto.

  Dado que este evento solo requiere un dedo, se puede simular en Studio usando el emulador y un ratón.

GuiObject.TouchTap

Se activa cuando el jugador realiza un gesto de toque en el elemento de la interfaz de usuario.

This code sample demonstrates a more involved usage of TweenPosition by
detecting when the tween completes/cancels by defining a callback function. It
also prints whether the tween will play.

Mueve suavemente una GUI a una nueva posición `Datatype.UDim2` en el tiempo especificado usando el especificado `Enum.EasingDirection` y `Enum.EasingStyle`.

  Esta función devolverá si el preadolescente jugará.No se reproducirá si otro preadolescente está actuando en el `Class.GuiObject` y el parámetro de anulación es `false` .

  Vea también `Class.GuiObject:TweenSize()` y `Class.GuiObject:TweenSizeAndPosition()` .

GuiObject:TweenPosition

endPosition

A dónde debe moverse la interfaz gráfica.

easingDirection

La dirección en la que facilitar la interfaz de usuario al final de la posición *endPosition*.

easingStyle

El estilo en el que facilitar la interfaz de usuario al final de la posición *endPosition*.

time

Cuánto tiempo, en segundos, debería tomar el preadolescente para completarse.

override

Si el preadolescente anulará un intermediación/interpolación de movimientoen curso.

callback

Una función de llamada de devolución para ejecutarse cuando el preadolescente se complete.

Mueve suavemente una GUI a una nueva `Datatype.UDim2`.

This code sample demonstrates the usage of the `Class.GuiObject:TweenSize()`
function. It initiates an animation on the parent's `Class.GuiObject.Size`
property to `UDim2.new(0.5, 0, 0.5, 0)`, which is half the `GuiObject`'s
parent size on both axes.

Additionally, it demonstrates how the callback parameter can be used to detect
when the tween stops (whether it was cancelled by another tween or completed).

Redimensiona suavemente un `Class.GuiObject` a un nuevo `Datatype.UDim2` en el tiempo especificado usando el especificado `Enum.EasingDirection` y `Enum.EasingStyle`.

  Esta función devolverá si el preadolescente jugará.Normalmente, esto siempre devolverá `true` , pero devolverá `false` si otro adolescente está activo y el anulado se establece en `false` .

  Vea también `Class.GuiObject:TweenSize()` y `Class.GuiObject:TweenSizeAndPosition()` .

GuiObject:TweenSize

endSize

La dirección en la que aliviar la GUI al tamaño final *endSize*.

El estilo en el que facilitar la interfaz de usuario al tamaño *final*.

Redimensiona suavemente un `Class.GuiObject` a un nuevo `Datatype.UDim2`.

The below example would tween a `Class.Frame` to the top left of the parent's
size and resize it down to 0.

Redimensiona y mueve suavemente una interfaz de usuario a un nuevo tamaño y posición en el tiempo especificado usando el especificado y .

  Esta función devolverá si el preadolescente jugará.Normalmente, esto siempre devolverá `true` , pero devolverá `false` si otro adolescente está activo y el anulado se establece en `false` .

  Vea también `Class.GuiObject:TweenSize()` y `Class.GuiObject:TweenSizeAndPosition()` .

GuiObject:TweenSizeAndPosition

La dirección en la que facilitar la interfaz de usuario al tamaño *final* y *posición final*.

El estilo en el que facilitar la interfaz de usuario al tamaño *final* y *posición final*.

Mueve suavemente una GUI a un nuevo tamaño y posición.

GuiObject

This code sample demonstrates the usage of the Active property as a debounce
for the Activated event.

Esta propiedad determina si el `Class.GuiObject` enviará la entrada al espacio 3D, como modelos subyacentes con una clase `Class.ClickDetector` como `Class.DragDetector`.

  Para objetos `Class.GuiButton` ( `Class.ImageButton` y `Class.TextButton` ), esta propiedad determina si se disparan `Class.GuiButton.Activated|Activated` fuegos ( `Class.GuiButton.AutoButtonColor|AutoButtonColor` seguirá funcionando para esos también).Los eventos `Class.GuiObject.InputBegan|InputBegan`, `Class.GuiObject.InputChanged|InputChanged` y `Class.GuiObject.InputEnded|InputEnded` trabajan como de costumbre sin importar el valor de esta propiedad.

GuiObject.Active

Determina si este elemento de interfaz de usuario sienta la entrada.

Este ejemplo de código mueve un elemento de interfaz de usuario a diferentes lados del elemento padre.Comienza en la parte superior izquierda y termina en la parte inferior derecha.Pegar en un LocalScript en un marco, dentro de un ScreenGui.

Esta propiedad determina el punto de origen de un `Class.GuiObject` , relativo a su tamaño absoluto.El punto de origen determina desde dónde se posiciona el elemento (a través de `Class.GuiObject.Position` ) y desde el cual se expande el renderizado `Class.GuiObject.Size` .

  Vea [aquí](/ui/position-and-size#anchorpoint) para diagramas ilustrados y detalles.

GuiObject.AnchorPoint

Determina el punto de origen de un `Class.GuiObject` , relativo a su tamaño absoluto.

El siguiente script crea un marco padre automáticamente escalado con un `UIListLayout` , luego inserta varios objetos automáticamente escalados `TextLabel` .Observe cómo el padre `UIListLayout` se redimensiona automáticamente para ajustarse a su contenido hijo y las etiquetas se redimensionan automáticamente para ajustarse a su contenido de texto.Este script puede ser padre de un `ScreenGui` .

Esta propiedad se usa para automatizar el tamaño de los objetos de la interfaz de usuario padre en función del tamaño de sus descendientes.Puedes usar esta propiedad para agregar dinámicamente texto y otro contenido a un objeto de interfaz de usuario en el momento de editar o ejecutar, y el tamaño se ajustará para que encaje con ese contenido.

  Cuando se establece en un valor a cualquier cosa diferente de , este objeto de interfaz de usuario puede redimensionarse según su contenido hijo.

  Para obtener más información sobre cómo usar esta propiedad y cómo funciona, consulte [aquí](/ui/size-modifiers#automatic-sizing).

GuiObject.AutomaticSize

Determina si se produce un redimensionamiento basado en el contenido de los hijos.

Determina el color del fondo `Class.GuiObject` .

GuiObject.BackgroundColor

This code sample causes a parent Frame to loop through all colors of the
rainbow using Color3.fromHSV.

Esta propiedad determina el color de un fondo `Class.GuiObject` (el color de relleno).Si tu elemento contiene texto, como un `Class.TextBox`, `Class.TextButton` o `Class.TextLabel`, asegúrate de que el color de tu fondo contraste con el color del texto.

  Otra propiedad que determina las propiedades visuales del fondo es `Class.GuiObject.BackgroundTransparency` ; si se establece en `1`, ni el fondo ni la frontera se Renderizar.

  Vea también `Class.GuiObject.BorderColor3|BorderColor3` .

GuiObject.BackgroundColor3

Determina el color de fondo `Class.GuiObject`.

Esta propiedad determina la transparencia del fondo y del borde `Class.GuiObject`.Sin embargo, no determina la transparencia del texto si la interfaz de usuario es un `Class.TextBox` , `Class.TextButton` o `Class.TextLabel` ; la transparencia del texto se determina `Class.TextBox.TextTransparency` , `Class.TextButton.TextTransparency` y `Class.TextLabel.TextTransparency` respectivamente.

  Si esta propiedad se establece en `1`, ni el fondo ni la frontera se renderizarán y el fondo de la interfaz de usuario será completamente transparente.

GuiObject.BackgroundTransparency

Determina la transparencia del fondo y del borde `Class.GuiObject`.

Determina el color del borde `Class.GuiObject` .

GuiObject.BorderColor

Este ejemplo de código hace que el borde de un GuiObject padre se resalte cuando el usuario pasa el mouse sobre el elemento.

Determina el color del borde rectangular `Class.GuiObject` (también conocido como el color del trazado).Esto se separa del `Class.GuiObject.BackgroundColor3` del objeto.No podrás ver el borde del objeto si su propiedad `Class.GuiObject.BorderSizePixel` está configurada como `0`.

  Tenga en cuenta que el componente `Class.UIStroke` permite efectos de borde más avanzados.

GuiObject.BorderColor3

Esta propiedad determina de qué manera se coloca el borde `Class.GuiObject` relativo a sus dimensiones usando el enumerado del mismo nombre, `Enum.BorderMode` .

  Tenga en cuenta que `Class.UIStroke` puede anular esta propiedad y permitir efectos de borde más avanzados.

GuiObject.BorderMode

Determina de qué manera se coloca el borde `Class.GuiObject` relativo a sus dimensiones.

Esta propiedad determina qué tan ancho se renderiza el borde `Class.GuiObject`, en píxeles. Establecer esto en 0 desactiva el borde por completo.

  Tenga en cuenta que `Class.UIStroke` puede anular esta propiedad y permitir efectos de borde más avanzados.

GuiObject.BorderSizePixel

Determina el ancho de píxel del borde `Class.GuiObject` .

Esta propiedad determina si el `Class.GuiObject` recortará (hará invisible) cualquier porción de elementos de interfaz gráfica descendientes que de lo contrario se renderizarían fuera de los límites del rectángulo.

  Tenga en cuenta que `Class.GuiObject.Rotation|Rotation` no es compatible con esta propiedad.Si esta o cualquier GUI ancestral tiene un no cero , esta propiedad se ignora y los elementos GUI descendientes se renderizarán independientemente del valor de esta propiedad.

GuiObject.ClipsDescendants

Determina si el descendiente `Class.GuiObject|GuiObjects` fuera de los límites de un elemento GUI padre debe Renderizar.

Esto indica si un `Class.GuiObject` (y sus descendientes) se pueden arrastrar por la pantalla.

GuiObject.Draggable

Determina si un `Class.GuiObject` (y sus descendientes) se pueden arrastrar por la pantalla.

Cuando el dedo del jugador se toca y se mantiene en el `Class.GuiObject`, el `Class.GuiObject.GuiState|GuiState` de la `Class.GuiObject` se establecerá en `Enum.GuiState.Press|Press` .Del mismo modo, cuando el dedo del jugador se libere de la `Class.GuiObject` , el `Class.GuiObject.GuiState|GuiState` de la `Class.GuiObject` se establecerá en `Enum.GuiState.Idle|Idle` , y cuando se desactive `Class.GuiObject.Interactable|Interactable` en el `Class.GuiObject` , el `Class.GuiState` de la `Class.GuiObject` se establecerá en `Enum.GuiState.NonInteractable|NonInteractable` .

GuiObject.GuiState

Determina si el mouse del jugador está presionado activamente en el `Class.GuiObject` o no.

Determina si el `Class.GuiButton` se puede interactuar o no, o si el `Enum.GuiState|GuiState` del `Class.GuiObject` está cambiando o no.

  En un `Class.GuiButton` :

  *   Cuando la configuración de `Class.GuiObject.Interactable|Interactable` en el `Class.GuiButton` se establece en `false` , el `Class.GuiButton` ya no podrá presionarse o hacer clic y el `Class.GuiObject.GuiState|GuiState` se establecerá constantemente en `Enum.GuiState.NonInteractable|NonInteractable`.
  *   Cuando la configuración de `Class.GuiObject.Interactable|Interactable` en el `Class.GuiButton` se establece en `true`, el `Class.GuiButton` se comportará normalmente de nuevo y el `Class.GuiObject.GuiState|GuiState` se comportará normalmente.

  En un `Class.GuiObject` :

  *   Cuando la configuración de `Class.GuiObject.Interactable|Interactable` en el `Class.GuiButton` se establece en `false`, la `Class.GuiObject.GuiState|GuiState` se establecerá constantemente en `Enum.GuiState.NonInteractable|NonInteractable`.
  *   Cuando la configuración de `Class.GuiObject.Interactable|Interactable` en el `Class.GuiButton` se establece en `true`, el `Class.GuiObject.GuiState|GuiState` se comportará normalmente de nuevo.

GuiObject.Interactable

Determina si el `Class.GuiButton` se puede interactuar o no, o si el `Enum.GuiState|GuiState` del `Class.GuiObject` está cambiando o no.

Esta propiedad controla el orden de clasificación del `Class.GuiObject` al usar un `Class.UIGridStyleLayout` (como `Class.UIListLayout` o `Class.UIPageLayout` ) con `Class.UIGridStyleLayout.SortOrder|SortOrder` establecido a `Enum.SortOrder.LayoutOrder` .No tiene funcionalidad si el objeto no tiene una estructura de interfaz de usuario hermana.

  `Class.GuiObject|GuiObjects` se ordenan en orden ascendente donde los valores más bajos tienen prioridad sobre los valores más altos.Los objetos con valores iguales vuelven a la orden en la que se agregaron.

  Si no está seguro de si necesitará agregar un elemento entre dos elementos existentes en el futuro, es una buena práctica usar múltiples de `100` (`0` , `100` , `200` , etc.).Esto garantiza un gran espacio de valores de orden de diseño que puedes usar para elementos ordenados entre otros elementos.

  Vea también que determina el orden de renderizado del objeto en lugar de ordenar el orden.

GuiObject.LayoutOrder

Controla el orden de clasificación del `Class.GuiObject` cuando se usa con un `Class.UIGridStyleLayout` .

Este ejemplo muestra cómo habilitar la navegación del Gamepad a través de una cuadrícula de `GuiObject|GUI` elementos sin tener que conectar manualmente las propiedades `Class.GuiObject.NextSelectionUp`, `Class.GuiObject.NextSelectionDown` y `GuiObject|NextSelectionRight` , y `Class.GuiObject.NextSelectionLeft` para cada elemento de la cuadrícula.

  Tenga en cuenta que este ejemplo de código asume que su `UIGridLayout` está ordenado por `Class.UIGridLayout.SortOrder|name`, donde los elementos se nombran en orden numérico sucesivo.

  El código se basa en esto para establecer las propiedades de selección siguiente para todo `GuiObjects` en el mismo nivel que el UIGridLayout.En nuestro ejemplo, el UIGridLayoutObject y los elementos de interfaz de usuario dentro de la cuadrícula son todos hijos de un `Frame` llamado *"Contenedor"*.El código `Class.Instance:GetChildren()|gets the children` de *"Contenedor"* y bucles a través de cada hijo.Los niños que no son GuiObjects se ignoran.Para cada elemento de interfaz gráfica, el código intenta asignar las propiedades de selección siguiente utilizando la siguiente lógica:

  1.  Comenzando con 1, el nombre de todos los elementos de interfaz de usuario coincide con su posición en la cuadrícula
  2.  Izquierda: el elemento a la izquierda siempre se numerará 1 menos que el elemento actual
  3.  Derecha: el elemento a la izquierda siempre se numerará 1 más que el elemento actual
  4.  Arriba: El elemento anterior (arriba) siempre será el número de interfaces gráficas en una fila 1 menos que el elemento actual
  5.  Abajo: el elemento siguiente (abajo) siempre será el número de interfaces en una fila más que el elemento actual Esta lógica también permite que los elementos de interfaz en el comienzo y el final de las filas (excluyendo el primer y último elemento) se envuelvan alrededor de las siguientes y anteriores filas.Si un elemento no existe a la izquierda, a la derecha, hacia arriba o hacia abajo, la siguiente selección permanecerá nula y mover el seleccionador del Gamepad en la dirección no cambiará la GUI seleccionada.

  Este ejemplo también contiene código para probar la cuadrícula usando las teclas de flecha (Arriba, Abajo, Izquierda, Derecha) de tu teclado en lugar de un gamepad, por si acaso no tienes un gamepad para probar.Esta parte del código inicialmente selecciona el elemento llamado *"1"* asignándolo a la propiedad `Class.GuiService.SelectedObject`.

Esta propiedad establece el `Class.GuiObject` seleccionado cuando el usuario mueve el seleccionador de [gamepad](/input/gamepad) hacia abajo.Si esta propiedad está vacía, mover el gamepad hacia abajo no cambiará la Interfaz gráfica (o GUI)seleccionada.

  Mover el selector del gamepad hacia abajo establece el `Class.GuiService.SelectedObject` a este objeto a menos que la interfaz gráfica no sea `Class.GuiObject.Selectable|Selectable` .Tenga en cuenta que esta propiedad se puede establecer en un elemento GUI incluso si no es `Class.GuiObject.Selectable|Selectable`, por lo que debe asegurarse de que el valor de una propiedad seleccionable de Interfaz gráfica (o GUI)coincida con su comportamiento esperado.

  Vea también `Class.GuiObject.NextSelectionUp|NextSelectionUp` , `Class.GuiObject.NextSelectionLeft|NextSelectionLeft` , y `Class.GuiObject.NextSelectionRight|NextSelectionRight` .

GuiObject.NextSelectionDown

Establece el `Class.GuiObject` que se seleccionará cuando el selector de gamepad se mueva hacia abajo.

Esta propiedad establece el `Class.GuiObject` seleccionado cuando el usuario mueve el seleccionador de [gamepad](/input/gamepad) a la izquierda.Si esta propiedad está vacía, mover el gamepad a la izquierda no cambiará la Interfaz gráfica (o GUI)seleccionada.

  Mover el seleccionador de gamepad a la izquierda establece el `Class.GuiService.SelectedObject` a este objeto a menos que la interfaz gráfica no sea `Class.GuiObject.Selectable|Selectable` .Tenga en cuenta que esta propiedad se puede establecer en un elemento GUI incluso si no es `Class.GuiObject.Selectable|Selectable`, por lo que debe asegurarse de que el valor de una propiedad seleccionable de Interfaz gráfica (o GUI)coincida con su comportamiento esperado.

  Vea también `Class.GuiObject.NextSelectionUp|NextSelectionUp` , `Class.GuiObject.NextSelectionDown|NextSelectionDown` , y `Class.GuiObject.NextSelectionRight|NextSelectionRight` .

GuiObject.NextSelectionLeft

Establece el `Class.GuiObject` que se seleccionará cuando el seleccionador de gamepad se mueva a la izquierda.

Esta propiedad establece el `Class.GuiObject` seleccionado cuando el usuario mueve el seleccionador de [gamepad](/input/gamepad) a la derecha.Si esta propiedad está vacía, mover el gamepad a la derecha no cambiará la Interfaz gráfica (o GUI)seleccionada.

  Mover el seleccionador de gamepad a la derecha establece el `Class.GuiService.SelectedObject` a este objeto a menos que la interfaz gráfica no sea `Class.GuiObject.Selectable|Selectable` .Tenga en cuenta que esta propiedad se puede establecer en un elemento GUI incluso si no es `Class.GuiObject.Selectable|Selectable`, por lo que debe asegurarse de que el valor de una propiedad seleccionable de Interfaz gráfica (o GUI)coincida con su comportamiento esperado.

  Vea también `Class.GuiObject.NextSelectionUp|NextSelectionUp` , `Class.GuiObject.NextSelectionDown|NextSelectionDown` , y `Class.GuiObject.NextSelectionLeft|NextSelectionLeft` .

GuiObject.NextSelectionRight

Establece el `Class.GuiObject` que se seleccionará cuando el seleccionador de gamepad se mueva a la derecha.

Esta propiedad establece el `Class.GuiObject` seleccionado cuando el usuario mueve el seleccionador de [gamepad](/input/gamepad) hacia arriba.Si esta propiedad está vacía, mover el gamepad hacia arriba no cambiará la Interfaz gráfica (o GUI)seleccionada.

  Mover el selector de gamepad hacia arriba establece el `Class.GuiService.SelectedObject` a este objeto a menos que la interfaz gráfica no sea `Class.GuiObject.Selectable|Selectable` .Tenga en cuenta que esta propiedad se puede establecer en un elemento GUI incluso si no es `Class.GuiObject.Selectable|Selectable`, por lo que debe asegurarse de que el valor de una propiedad seleccionable de Interfaz gráfica (o GUI)coincida con su comportamiento esperado.

  Vea también `Class.GuiObject.NextSelectionDown|NextSelectionDown` , `Class.GuiObject.NextSelectionLeft|NextSelectionLeft` , `Class.GuiObject.NextSelectionRight|NextSelectionRight` .

GuiObject.NextSelectionUp

Establece el `Class.GuiObject` que se seleccionará cuando el seleccionador de gamepad se mueva hacia arriba.

Esta propiedad determina la posición `Class.GuiObject` píxel y escalar usando un `Datatype.UDim2` . La posición se centra alrededor de la posición del objeto `Class.GuiObject.AnchorPoint` .

  La posición escalar es relativa al tamaño del elemento GUI padre, si es que existe.

  Las porciones de píxeles del valor `Datatype.UDim2` son iguales independientemente del tamaño de la Interfaz gráfica (o GUI)padre.Los valores representan la posición del objeto en píxeles.La posición real de píxeles de un objeto se puede leer de la propiedad `Class.GuiBase2d.AbsolutePosition`.

GuiObject.Position

Determina la posición píxel y escalar del `Class.GuiObject` .

Esta propiedad determina el número de grados por los cuales se gira el `Class.GuiObject` .La rotación es relativa al centro del objeto, no al punto de rotación, lo que significa que no puedes cambiar el punto de rotación.Además, esta propiedad no es compatible con `Class.GuiObject.ClipsDescendants|ClipsDescendants` .

GuiObject.Rotation

Determina el número de grados por los cuales se gira el `Class.GuiObject` .

The example below offers a simple demonstration on how to use the
`Class.GuiObject.Selectable` property to limit when a GUI element can be
selected by the Gamepad navigator.

When a `TextBox` has gains focus, it can be selected. However, when a TextBox
loses focus it can no longer be selected.

Although this is a simple demonstration, the property can also be used to
prevent the navigator from selecting UI elements that exist for cosmetic
rather than functional purposes. For instance, while the buttons on a menu
screen should be selectable, the title image should not be.

Esta propiedad determina si la `Class.GuiObject` se puede seleccionar al navegar por las interfaces gráficas usando un controlador para juego.

  Si esta propiedad es `true`, se puede seleccionar una interfaz gráfica de usuario. Seleccionar una interfaz gráfica de usuario también establece la propiedad `Class.GuiService.SelectedObject` a ese objeto.

  Cuando esto es `false`, la interfaz gráfica no se puede seleccionar.Sin embargo, establecer esto en `false` cuando se selecciona una GUI no lo deseleccionará ni cambiará el valor de la propiedad `Class.GuiService.SelectedObject`.

  Añade `Class.GuiObject.SelectionGained` y `Class.GuiObject.SelectionLost` no disparará por el elemento. Para deseleccionar un GuiObject, debes cambiar la propiedad `Class.GuiService.SelectedObject`.

  Esta propiedad es útil si una interfaz gráfica se conecta a varias interfaces gráficas a través de propiedades como esta `Class.GuiObject.NextSelectionUp`, `Class.GuiObject.NextSelectionDown`, `Class.GuiObject|NextSelectionRight` o `Class.GuiObject|NextSelectionLeft`.En lugar de cambiar todas las propiedades para que el Gamepad no pueda seleccionar la Interfaz gráfica (o GUI), puedes deshabilitar su propiedad seleccionable para evitar que se seleccione temporalmente.Entonces, cuando quieras que el seleccionador de gamepad pueda seleccionar la interfaz de usuario, simplemente vuelve a habilitar su propiedad seleccionable.

GuiObject.Selectable

Determine si el `Class.GuiObject` se puede seleccionar por un controlador para juego.

Esta propiedad anula el adorno de selección predeterminado utilizado para los gamepads.

  Tenga en cuenta que el recubrimiento elegido `Class.GuiObject.SelectionImageObject|SelectionImageObject` superpone el recubrimiento seleccionado `Class.GuiObject` con el `Class.GuiObject.Size|Size` de la imagen.Para obtener los mejores resultados, debe escalar el personalizado `SelectionImageObject` a través de los valores de escala `Datatype.UDim2` para ayudar a garantizar que el objeto se escala correctamente sobre el elemento seleccionado.

  Cambiar el `Class.GuiObject.SelectionImageObject|SelectionImageObject` por un elemento `Class.GuiObject` solo afecta ese elemento. Para afectar todos los elementos de la interfaz gráfica del usuario, establece la propiedad `Class.PlayerGui.SelectionImageObject`.

  Para determinar o establecer qué elemento de interfaz de usuario se selecciona por el usuario, puedes usar la propiedad `Class.GuiService.SelectedObject`.El jugador usa el gamepad para seleccionar diferentes elementos de interfaz de usuario, invocando los eventos `Class.GuiObject.NextSelectionUp|NextSelectionUp`, `Class.GuiObject.NextSelectionDown|NextSelectionDown`, `Class.GuiObject.NextSelectionLeft|NextSelectionLeft` y `Class.GuiObject.NextSelectionRight|NextSelectionRight`.

GuiObject.SelectionImageObject

Anula el adorno de selección predeterminado utilizado para los gamepads.

Una clase abstracta para todos los objetos de interfaz de usuario 2D.