UE3:UIEvent (UDK)

From Unreal Wiki, The Unreal Engine Documentation Site
UDK Object >> SequenceObject >> SequenceOp >> SequenceEvent >> UIEvent
Package:
Engine
Direct subclasses:
UIEvent_CalloutButtonInputProxy, UIEvent_Initialized, UIEvent_MetaObject, UIEvent_OnClick, UIEvent_OnDoubleClick, UIEvent_ProcessInput, UIEvent_Scene, UIEvent_State, UIEvent_ValueChanged, UTUIEvent
This class in other games:
This is an auto-generated page and may need human attention.
Please remove the {{autogenerated}} tag if the page seems reasonably complete or replace it with the {{expand}} tag if the page is not yet complete.

Abstract base class for UI events. A UIEvent is some event that a widget can respond to. It could be an input event such as a button press, or a system event such as receiving data from a remote system. UIEvents are generally not bound to a particular type of widget; programmers choose which events are available to widgets, and artists decide which events to implement.

Features: Able to execute multiple actions when the event is called. Able to operate on multiple widgets simultaneously.

Properties

bPropagateEvent

Type: bool

Indicates whether this activation of this event type should be propagated up the parent chain.

Default value: True

bShouldRegisterEvent

Type: bool

Indicates whether this event should be added to widget sequences. Used for special-case handling of certain types of events.

Default value: True

Description

Type: string

Modifiers: localized

a short description of what this event does - displayed as a tooltip in the editor when the user hovers over this event in the editor

EventActivator

Type: Object

the object that initiated this event; specific to each event

EventOwner

Type: UIScreenObject

Modifiers: noimport

the widget that contains this event

SubobjectVersionModifier

Type: int

Modifiers: const

An additional value to add to the result of GetObjClassVersion() for use in UIEvent subobject definitions. This value is intended only for use when overriding link arrays in subobjects, thus should never be set in defaultproperties.

Default values

Property Value
bClientSideOnly True
MaxTriggerCount 0
ObjCategory "UI"
VariableLinks[0]
Member Value
LinkDesc "Activator"
VariableLinks[1]
Member Value
bHidden True
bWriteable True
ExpectedType Class'Engine.SeqVar_Int'
LinkDesc "Player Index"
PropertyName 'PlayerIndex'
VariableLinks[2]
Member Value
bHidden True
bWriteable True
ExpectedType Class'Engine.SeqVar_Int'
LinkDesc "Gamepad Id"
PropertyName 'GamepadID'

Delegates

AllowEventActivation

delegate bool AllowEventActivation (int ControllerIndex, UIScreenObject InEventOwner, Object InEventActivator, bool bActivateImmediately, out const array<int> IndicesToActivate)

Allows script-only child classes or other objects to include additional logic for determining whether this event is eligible for activation.

Parameters:

  • ControllerIndex - the index of the player that activated this event
  • InEventOwner - the widget that owns this UIEvent
  • InEventActivator - an optional object that can be used for various purposes in UIEvents; typically the widget that triggered the event activation.
  • bActivateImmediately - TRUE if the caller wishes to perform immediate activation.
  • IndicesToActivate - indexes of the elements [into the Output array] that are going to be activated. If empty, all output links will be activated

Returns:

TRUE if this event can be activated

Functions

Static events

GetObjClassVersion

static event int GetObjClassVersion ()

Overrides: SequenceObject.GetObjClassVersion

Return the version number for this class. Child classes should increment this method by calling Super then adding a individual class version to the result. When a class is first created, the number should be 0; each time one of the link arrays is modified (VariableLinks, OutputLinks, InputLinks, etc.), the number that is added to the result of Super.GetObjClassVersion() should be incremented by 1.

Returns:

the version number for this specific class.

Native functions

ActivateUIEvent

native final noexport function bool ActivateUIEvent (int ControllerIndex, UIScreenObject InEventOwner, optional Object InEventActivator, optional bool bActivateImmediately, optional out const array<int> IndicesToActivate)

Activates this UIEvent, adding it the list of active sequence operations in the owning widget's EventProvider

Parameters:

  • ControllerIndex - the index of the player that activated this event
  • InEventOwner - the widget that contains this UIEvent
  • InEventActivator - an optional object that can be used for various purposes in UIEvents
  • bActivateImmediately - if TRUE, the event will be activated immediately, rather than deferring activation until the next tick
  • IndicesToActivate - Indexes into this UIEvent's Output array to activate. If not specified, all output links will be activated

Returns:

TRUE if this event was successfully activated

Note: noexport so that the native function header can take a TArray<INT> pointer as the last parameter

CanBeActivated

native final noexport function bool CanBeActivated (int ControllerIndex, UIScreenObject InEventOwner, optional Object InEventActivator, optional bool bActivateImmediately, optional out const array<int> IndicesToActivate)

Determines whether this UIAction can be activated.

Parameters:

  • ControllerIndex - the index of the player that activated this event
  • InEventOwner - the widget that contains this UIEvent
  • InEventActivator - an optional object that can be used for various purposes in UIEvents
  • bActivateImmediately - specify true to indicate that we'd like to know whether this event can be activated immediately
  • IndicesToActivate - Indexes into this UIEvent's Output array to activate. If not specified, all output links will be activated

Returns:

TRUE if this event can be activated

Note: noexport so that the native function header can take a TArray<INT> pointer as the last parameter

ConditionalActivateUIEvent

native final noexport function bool ConditionalActivateUIEvent (int ControllerIndex, UIScreenObject InEventOwner, optional Object InEventActivator, optional bool bActivateImmediately, optional out const array<int> IndicesToActivate)

Activates this event if CanBeActivated returns TRUE.

Parameters:

  • ControllerIndex - the index of the player that activated this event
  • InEventOwner - the widget that contains this UIEvent
  • InEventActivator - an optional object that can be used for various purposes in UIEvents
  • bActivateImmediately - if TRUE, the event will be activated immediately, rather than deferring activation until the next tick
  • IndicesToActivate - Indexes into this UIEvent's Output array to activate. If not specified, all output links will be activated

Returns:

TRUE if this event was successfully activated

Note: noexport so that the native function header can take a TArray<INT> pointer as the last parameter

GetOwner

native final function UIScreenObject GetOwner () const

Returns the widget that contains this UIEvent.

GetOwnerScene

native final function UIScene GetOwnerScene () const

Returns the scene that contains this UIEvent.

Events

IsValidLevelSequenceObject

event bool IsValidLevelSequenceObject ()

Overrides: SequenceObject.IsValidLevelSequenceObject

Determines whether this class should be displayed in the list of available ops in the level kismet editor.

Returns:

TRUE if this sequence object should be available for use in the level kismet editor

IsValidUISequenceObject

event bool IsValidUISequenceObject (optional UIScreenObject TargetObject)

Overrides: SequenceObject.IsValidUISequenceObject

Determines whether this class should be displayed in the list of available ops in the UI's kismet editor.

Parameters:

  • TargetObject - the widget that this SequenceObject would be attached to.

Returns:

TRUE if this sequence object should be available for use in the UI kismet editor

ShouldAlwaysInstance

event bool ShouldAlwaysInstance ()

Allows events to override the default behavior of not instancing event templates during the game (@see UIComp_Event::InstanceEventTemplates); by default, events templates declared in widget defaultproperties are only instanced if the template definition contains linked ops. If your event class performs some other actions which affect the game when it's activated, you can use this function to force the UI to instance this event for widgets created at runtime in the game.

Returns:

return TRUE to force the UI to always instance event templates of this event type, even if there are no linked ops.
Retrieved from "https://wiki.beyondunreal.com/index.php?title=UE3:UIEvent_(UDK)&oldid=41882"