DropTarget - Guía del usuario de Lumberyard

DropTarget

Puede utilizar el componente DropTarget (Destino de soltar) para implementar el comportamiento de arrastrar y soltar con el componente Draggable (Arrastrable).

Como el comportamiento de "arrastrar y soltar" es específico del juego, los componentes Draggable (Arrastrable) y DropTarget (Destino de soltar) se han diseñado para que se utilicen con scripts o código C++ que definan acciones derivadas de esta acción.

Para añadir el componente DropTarget (Destino de soltar) a un elemento de la interfaz de usuario, utilice el menú Add Component (Añadir componente) del panel Properties (Propiedades).

En la imagen siguiente se muestra un ejemplo de un componente DropTarget (Destino de soltar) en el que se ha añadido color a las acciones de estado para Drop States (Estados de soltar).

El componente DropTarget (Destino de soltar) comparte propiedades con los componentes interactivos, como las acciones de estados y las opciones de navegación.

Para editar un componente DropTarget

En el panel Properties (Propiedades) de UI Editor, expanda DropTarget (Destino de soltar) y realice las acciones siguientes, según corresponda:

Drop States (Estados de soltar)

Establece las propiedades Color, Alpha, Sprite o Font de este elemento y sus elementos secundarios en un estado que es válido o no válido para la acción "soltar". De forma predeterminada, el estado de un destino de la acción "soltar" es Normal, lo que significa que no hay sobrescritura visual.

En una acción de soltar, el componente de destino puede ser Valid (Válido) o Invalid (No válido). Como el componente de destino de soltar no tiene conocimiento de lo que es una operación de "arrastrar y soltar" válida, utilizará un script o código C++ para cambiar el destino de la acción de "soltar" a los estados Normal (Normal), Valid (Válido) e Invalid (No válido). Normalmente, esto se consigue conectando el bus UiDropTargetNotifications y la escucha de las notificaciones de OnDropHoverStart y OnDropHoverEnd.

Navegación

Las opciones de Navigation controlan cómo funciona la navegación a través del teclado o el gamepad durante una operación "arrastrar y soltar". Si utiliza el teclado, puede pulsar Intro en un elemento arrastrable para entrar en modo de arrastrar. A continuación, puede utilizar las teclas de flecha para mover el elemento de un destino a otro aplicando las opciones de Navigation especificadas aquí.

Actions, On Drop (Acciones, Al soltar)

Introduzca una cadena de texto. Esta cadena se envía como una acción del lienzo de la interfaz de usuario cuando se suelta un elemento Draggable en este destino. Para mejorar el control, recomendamos utilizar el bus UiDropTargetNotifications en su lugar.

Para ver un ejemplo de un script Lua con un destino de la acción "soltar", abra DropTarget.lua Gems\LyShineExamples\Assets\UI\Scripts\LyShineExamples\DragAndDrop.