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.
UiTextInputComponent Class Reference

Inherits UiInteractableComponent, UiInitializationBus::Handler, and UiTextInputBus::Handler.

Public Types

using EntityComboBoxVec = AZStd::vector< AZStd::pair< AZ::EntityId, AZStd::string > >
 

Public Member Functions

 AZ_COMPONENT (UiTextInputComponent, LyShine::UiTextInputComponentUuid, AZ::Component)
 
bool HandlePressed (AZ::Vector2 point, bool &shouldStayActive) override
 
bool HandleReleased (AZ::Vector2 point) override
 
bool HandleEnterPressed (bool &shouldStayActive) override
 
bool HandleEnterReleased () override
 
bool HandleAutoActivation () override
 
bool HandleTextInput (const AZStd::string &textUTF8) override
 
bool HandleKeyInputBegan (const AzFramework::InputChannel::Snapshot &inputSnapshot, AzFramework::ModifierKeyMask activeModifierKeys) override
 
void InputPositionUpdate (AZ::Vector2 point) override
 
void LostActiveStatus () override
 
void Update (float deltaTime) override
 
void InGamePostActivate () override
 
bool GetIsPasswordField () override
 
void SetIsPasswordField (bool passwordField) override
 
uint32_t GetReplacementCharacter () override
 
void SetReplacementCharacter (uint32_t replacementChar) override
 
AZ::Color GetTextSelectionColor () override
 
void SetTextSelectionColor (const AZ::Color &color) override
 
AZ::Color GetTextCursorColor () override
 
void SetTextCursorColor (const AZ::Color &color) override
 
float GetCursorBlinkInterval () override
 
void SetCursorBlinkInterval (float interval) override
 
int GetMaxStringLength () override
 
void SetMaxStringLength (int maxCharacters) override
 
TextInputCallback GetOnChangeCallback () override
 
void SetOnChangeCallback (TextInputCallback callbackFunction) override
 
TextInputCallback GetOnEndEditCallback () override
 
void SetOnEndEditCallback (TextInputCallback callbackFunction) override
 
TextInputCallback GetOnEnterCallback () override
 
void SetOnEnterCallback (TextInputCallback callbackFunction) override
 
const LyShine::ActionNameGetChangeAction () override
 
void SetChangeAction (const LyShine::ActionName &actionName) override
 
const LyShine::ActionNameGetEndEditAction () override
 
void SetEndEditAction (const LyShine::ActionName &actionName) override
 
const LyShine::ActionNameGetEnterAction () override
 
void SetEnterAction (const LyShine::ActionName &actionName) override
 
AZ::EntityId GetTextEntity () override
 
void SetTextEntity (AZ::EntityId textEntity) override
 
AZStd::string GetText () override
 
void SetText (const AZStd::string &text) override
 
AZ::EntityId GetPlaceHolderTextEntity () override
 
void SetPlaceHolderTextEntity (AZ::EntityId textEntity) override
 
bool GetIsClipboardEnabled () override
 
void SetIsClipboardEnabled (bool enableClipboard) override
 
- Public Member Functions inherited from UiInteractableComponent
 AZ_RTTI (UiInteractableComponent, "{A42EB486-1C89-434C-AD22-A3FC6CEEC46F}", AZ::Component)
 
bool CanHandleEvent (AZ::Vector2 point) override
 
bool HandlePressed (AZ::Vector2 point, bool &shouldStayActive) override
 
bool HandleReleased (AZ::Vector2 point) override
 
bool HandleMultiTouchPressed (AZ::Vector2 point, int multiTouchIndex) override
 
bool HandleMultiTouchReleased (AZ::Vector2 point, int multiTouchIndex) override
 
bool HandleEnterPressed (bool &shouldStayActive) override
 
bool HandleEnterReleased () override
 
void InputPositionUpdate (AZ::Vector2 point) override
 
void MultiTouchPositionUpdate (AZ::Vector2 point, int multiTouchIndex) override
 
void LostActiveStatus () override
 
void HandleHoverStart () override
 
void HandleHoverEnd () override
 
void HandleReceivedHoverByNavigatingFromDescendant (AZ::EntityId descendantEntityId) override
 
bool IsPressed () override
 
bool IsHandlingEvents () override
 
void SetIsHandlingEvents (bool isHandlingEvents) override
 
bool IsHandlingMultiTouchEvents () override
 
void SetIsHandlingMultiTouchEvents (bool isHandlingMultiTouchEvents) override
 
bool GetIsAutoActivationEnabled () override
 
void SetIsAutoActivationEnabled (bool isEnabled) override
 
void Update (float deltaTime) override
 
void OnUiElementFixup (AZ::EntityId canvasEntityId, AZ::EntityId parentEntityId) override
 
void OnUiElementAndAncestorsEnabledChanged (bool areElementAndAncestorsEnabled) override
 
const LyShine::ActionNameGetHoverStartActionName () override
 
void SetHoverStartActionName (const LyShine::ActionName &actionName) override
 
const LyShine::ActionNameGetHoverEndActionName () override
 
void SetHoverEndActionName (const LyShine::ActionName &actionName) override
 
const LyShine::ActionNameGetPressedActionName () override
 
void SetPressedActionName (const LyShine::ActionName &actionName) override
 
const LyShine::ActionNameGetReleasedActionName () override
 
void SetReleasedActionName (const LyShine::ActionName &actionName) override
 
OnActionCallback GetHoverStartActionCallback () override
 
void SetHoverStartActionCallback (OnActionCallback onActionCallback) override
 
OnActionCallback GetHoverEndActionCallback () override
 
void SetHoverEndActionCallback (OnActionCallback onActionCallback) override
 
OnActionCallback GetPressedActionCallback () override
 
void SetPressedActionCallback (OnActionCallback onActionCallback) override
 
OnActionCallback GetReleasedActionCallback () override
 
void SetReleasedActionCallback (OnActionCallback onActionCallback) override
 

Protected Member Functions

void Activate () override
 
void Deactivate () override
 
bool IsAutoActivationSupported () override
 
void BeginEditState ()
 
void EndEditState ()
 
float GetValidDragDistanceInPixels (AZ::Vector2 startPoint, AZ::Vector2 endPoint)
 
void CheckForDragOrHandOffToParent (AZ::Vector2 point)
 
void UpdateDisplayedTextFunction ()
 
void OnReplacementCharacterChange ()
 
EntityComboBoxVec PopulateTextEntityList ()
 
UiInteractableStatesInterface::State ComputeInteractableState () override
 Compute the current Interactable state based on internal state flags.
 
- Protected Member Functions inherited from UiInteractableComponent
void Init () override
 
void Activate () override
 
void Deactivate () override
 
virtual UiInteractableStatesInterface::State ComputeInteractableState ()
 Compute the current Interactable state based on internal state flags.
 
void OnHoverStateActionsChanged ()
 
void OnPressedStateActionsChanged ()
 
void OnDisabledStateActionsChanged ()
 
void TriggerHoverStartAction ()
 
void TriggerHoverEndAction ()
 
void TriggerPressedAction ()
 
void TriggerReleasedAction ()
 
void TriggerReceivedHoverByNavigatingFromDescendantAction (AZ::EntityId descendantEntityId)
 
virtual bool IsAutoActivationSupported ()
 

Static Protected Member Functions

static void GetProvidedServices (AZ::ComponentDescriptor::DependencyArrayType &provided)
 
static void GetIncompatibleServices (AZ::ComponentDescriptor::DependencyArrayType &incompatible)
 
static void GetRequiredServices (AZ::ComponentDescriptor::DependencyArrayType &required)
 
static void Reflect (AZ::ReflectContext *context)
 

Additional Inherited Members

- Static Public Member Functions inherited from UiInteractableComponent
static void Reflect (AZ::ReflectContext *context)
 
- Protected Types inherited from UiInteractableComponent
using StateActions = AZStd::vector< UiInteractableStateAction * >
 
- Protected Attributes inherited from UiInteractableComponent
StateActions m_hoverStateActions
 Selected/Hover state properties.
 
StateActions m_pressedStateActions
 Pressed state properties.
 
StateActions m_disabledStateActions
 Disabled state properties.
 
LyShine::ActionName m_hoverStartActionName
 Action triggered on hover start.
 
LyShine::ActionName m_hoverEndActionName
 Action triggered on hover end.
 
LyShine::ActionName m_pressedActionName
 Action triggered on pressed.
 
LyShine::ActionName m_releasedActionName
 Action triggered on release.
 
bool m_isAutoActivationEnabled
 
bool m_isHandlingEvents
 True if this interactable is accepting input (i.e. not in disabled state)
 
bool m_isHandlingMultiTouchEvents
 True if this interactable is handling multi-touch input events.
 
bool m_isHover
 True if this interactable is being hovered (can be true at the same time as m_isPressed)
 
bool m_isPressed
 True if the interactable is in the pressed state (which can be true while dragging)
 
AZ::Vector2 m_pressedPoint
 the viewport position at which the press event occured (only valid if m_isPressed is true)
 
UiInteractableStatesInterface::State m_state
 The current interactable state. This is stored so that we can detect state changes.
 
OnActionCallback m_hoverStartActionCallback
 Callback triggered on hover start.
 
OnActionCallback m_hoverEndActionCallback
 Callback triggered on hover end.
 
OnActionCallback m_pressedActionCallback
 Callback triggered on pressed.
 
OnActionCallback m_releasedActionCallback
 Callback triggered on release.
 
UiStateActionManager m_stateActionManager
 
UiNavigationSettings m_navigationSettings
 

Member Function Documentation

◆ ComputeInteractableState()

UiInteractableStatesInterface::State UiTextInputComponent::ComputeInteractableState ( )
overrideprotectedvirtual

Compute the current Interactable state based on internal state flags.

Reimplemented from UiInteractableComponent.

◆ IsAutoActivationSupported()

bool UiTextInputComponent::IsAutoActivationSupported ( )
overrideprotectedvirtual

Reimplemented from UiInteractableComponent.

◆ UpdateDisplayedTextFunction()

void UiTextInputComponent::UpdateDisplayedTextFunction ( )
protected

Changes the DisplayedTextFunction callback of our child m_textEntity If m_isPasswordField is true, we assign a callback that replaces the contents of the displayed string with our m_replacementCharacter, otherwise we assign a null callback (default behavior).


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