Open 3D Engine LyShine Gem API Reference 23.10.0
O3DE is an open-source, fully-featured, high-fidelity, modular 3D engine for building games and simulations, available to every industry.
UiDropdownInterface Class Referenceabstract

#include <UiDropdownBus.h>

Inherits AZ::ComponentBus.

Public Member Functions

virtual AZ::EntityId GetValue ()=0
 Get the currently selected option.
 
virtual void SetValue (AZ::EntityId value)=0
 Set the currently selected option manually.
 
virtual AZ::EntityId GetContent ()=0
 Get the content element this dropdown will expand.
 
virtual void SetContent (AZ::EntityId content)=0
 Set the content element this dropdown will expand.
 
virtual bool GetExpandOnHover ()=0
 Get whether this dropdown should expand automatically on hover.
 
virtual void SetExpandOnHover (bool expandOnHover)=0
 Set whether this dropdown should expand automatically on hover.
 
virtual float GetWaitTime ()=0
 Get how long to wait before expanding upon hover / collapsing upon exit.
 
virtual void SetWaitTime (float waitTime)=0
 Set how long to wait before expanding upon hover / collapsing upon exit.
 
virtual bool GetCollapseOnOutsideClick ()=0
 Get whether this dropdown should collapse when the user clicks outside.
 
virtual void SetCollapseOnOutsideClick (bool collapseOnOutsideClick)=0
 Set whether this dropdown should collapse when the user clicks outside.
 
virtual AZ::EntityId GetExpandedParentId ()=0
 Get the element the dropdown content will parent to when expanded (the canvas by default)
 
virtual void SetExpandedParentId (AZ::EntityId expandedParentId)=0
 Set the element the dropdown content will parent to when expanded.
 
virtual AZ::EntityId GetTextElement ()=0
 Get the text element to display to show the currently selected option.
 
virtual void SetTextElement (AZ::EntityId textElement)=0
 Set the text element to display to show the currently selected option.
 
virtual AZ::EntityId GetIconElement ()=0
 Get the icon element to display to show the currently selected option.
 
virtual void SetIconElement (AZ::EntityId iconElement)=0
 Set the icon element to display to show the currently selected option.
 
virtual void Expand ()=0
 Expand the dropdown.
 
virtual void Collapse ()=0
 Collapse the dropdown.
 
virtual const LyShine::ActionNameGetExpandedActionName ()=0
 Get the name of the action that is sent when the dropdown is expanded.
 
virtual void SetExpandedActionName (const LyShine::ActionName &actionName)=0
 Set the name of the action that is sent when the dropdown is expanded.
 
virtual const LyShine::ActionNameGetCollapsedActionName ()=0
 Get the name of the action that is sent when the dropdown is collapsed.
 
virtual void SetCollapsedActionName (const LyShine::ActionName &actionName)=0
 Set the name of the action that is sent when the dropdown is collapsed.
 
virtual const LyShine::ActionNameGetOptionSelectedActionName ()=0
 Get the name of the action that is sent when the dropdown value is changed.
 
virtual void SetOptionSelectedActionName (const LyShine::ActionName &actionName)=0
 Set the name of the action that is sent when the dropdown value is changed.
 

Static Public Attributes

static const AZ::EBusHandlerPolicy HandlerPolicy = AZ::EBusHandlerPolicy::Single
 Only one component on a entity can implement the events.
 

Detailed Description

The UI Dropdown Component is an interactable component which displays a list of options when clicked. In its default state, the dropdown display a simple button, next to an arrow indicating the dropdown functionality. When the arrow / option is clicked, the dropdown list appears, displaying the options available. If the list is too long to be displayed, a scrollbar can be added to scroll up and down the list of options.


The documentation for this class was generated from the following file: