Mostly Harmless
UE3:UIScene functions (UDK)
Object >> UIRoot >> UIScreenObject >> UIScene (functions) |
Contents
- 1 Functions
- 1.1 Static native functions
- 1.2 Native functions
- 1.2.1 FindTickableObjectIndex
- 1.2.2 ForceImmediateSceneUpdate
- 1.2.3 GetActiveContextMenu
- 1.2.4 GetDefaultContextMenu
- 1.2.5 GetNextScene
- 1.2.6 GetPreviousScene
- 1.2.7 GetSceneDataStore
- 1.2.8 GetSceneInputMode
- 1.2.9 GetScenePostProcessGroup
- 1.2.10 GetSceneRenderMode
- 1.2.11 IsSceneActive
- 1.2.12 LoadSceneDataValues
- 1.2.13 LogDockingStack
- 1.2.14 RebuildDockingStack
- 1.2.15 RegisterTickableObject
- 1.2.16 ResolveDataStore
- 1.2.17 ResolveScenePositions
- 1.2.18 SaveSceneDataValues
- 1.2.19 SetActiveContextMenu
- 1.2.20 SetSceneInputMode
- 1.2.21 SetSceneRenderMode
- 1.2.22 ShouldRenderParentScenes
- 1.2.23 UnbindSubscribers
- 1.2.24 UnregisterTickableObject
- 1.3 Events
- 1.4 Other instance functions
- 1.4.1 BeginSceneAnimation
- 1.4.2 BeginSceneCloseAnimation
- 1.4.3 BeginSceneLostFocusAnimation
- 1.4.4 BeginSceneOpenAnimation
- 1.4.5 BeginSceneRegainedFocusAnimation
- 1.4.6 BeginSceneRegainingFocusAnimation
- 1.4.7 DebugShowAnimators
- 1.4.8 FindAnimatorIndex
- 1.4.9 LogCurrentState
- 1.4.10 LogRenderBounds
- 1.4.11 NotifyControllerStatusChanged
- 1.4.12 NotifyGameSessionEnded
- 1.4.13 NotifyLinkStatusChanged
- 1.4.14 NotifyLoginStatusChanged
- 1.4.15 NotifyOnlineServiceStatusChanged
- 1.4.16 NotifyPlayerAdded
- 1.4.17 NotifyPlayerRemoved
- 1.4.18 NotifyPreClientTravel
- 1.4.19 NotifyStorageDeviceChanged
- 1.4.20 OnCloseAnimationComplete
- 1.4.21 OnCloseAnimationComplete_IgnoreChildScenes
- 1.4.22 OnLostFocusAnimationComplete
- 1.4.23 OnOpenAnimationComplete
- 1.4.24 OnRegainedFocusAnimationComplete
- 1.4.25 OnRegainingFocusAnimationComplete
- 1.4.26 SceneCreated
- 1.4.27 StopSceneAnimation
;Other member categories for this class::properties
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. |
Functions[edit]
Static native functions[edit]
GetWorldInfo[edit]
Returns the current WorldInfo
Native functions[edit]
FindTickableObjectIndex[edit]
Finds the location of a tickable object.
Parameters:
- ObjectToFind - the object to search for
Returns:
- the index into the scene's TickableObjects array for the specified object, or INDEX_NONE if it isn't found.
ForceImmediateSceneUpdate[edit]
Triggers an immediate full scene update (rebuilds docking stacks if necessary, resolves scene positions if necessary, etc.); scene updates normally occur at the beginning of each scene's Tick() so this function should only be called if you must change the positions and/or formatting of a widget in the scene after the scene has been ticked, but before it's been rendered.
Note: noexport because this simply calls through to the C++ UpdateScene().
GetActiveContextMenu[edit]
Returns the scene's currently active context menu, if there is one.
GetDefaultContextMenu[edit]
Returns the scene's default context menu widget, creating one if necessary.
GetNextScene[edit]
Returns the scene that is above this one in the scene client's stack of active scenes.
Parameters:
- bRequireMatchingPlayerOwner - TRUE indicates that only a scene that has the same value for PlayerOwner as this scene may be considered the "next" scene to this one
- bIgnoreUnfocusedScenes - indicates that scenes which cannot accept focus should be skipped.
Returns:
- a reference to the next scene above this scene in the ActiveScenes array which meets the criteria specified by the input parameters, or None if there isn't one.
GetPreviousScene[edit]
Returns the scene that is below this one in the scene client's stack of active scenes.
Parameters:
- bRequireMatchingPlayerOwner - TRUE indicates that only a scene that has the same value for PlayerOwner as this scene may be considered the "previous" scene to this one
- bIgnoreUnfocusedScenes - indicates that scenes which cannot accept focus should be skipped.
Returns:
- a reference to the next scene below this scene in the ActiveScenes array which meets the criteria specified by the input parameters, or None if there isn't one.
GetSceneDataStore[edit]
Gets the data store for this scene, creating one if necessary.
GetSceneInputMode[edit]
Accessor for retrieving the scene's input mode.
Parameters:
- bMemberValueOnly - specify TRUE to skip calling the delegate and just return the value of SceneInputMode
Returns:
- if the scene's GetSceneInputModeOverride delegate is set, returns the result from that. Otherwise, the value of this scene's SceneInputMode.
GetScenePostProcessGroup[edit]
Accessor for retrieving the scene's configured post-process group.
Returns:
- the post-process group that this scene is configured to use.
GetSceneRenderMode[edit]
Accessor for retrieving the scene's render mode. Forces render mode to be SPLITRENDER_FullScreen
Returns:
- the value of this scene's SceneRenderMode member.
IsSceneActive[edit]
Wrapper for easily determining whether this scene is in the scene client's list of active scenes.
Parameters:
- bTopmostScene - specify TRUE to check whether the scene is also the scene client's topmost scene.
LoadSceneDataValues[edit]
Notifies all children that are bound to readable data stores to retrieve their initial value from those data stores.
LogDockingStack[edit]
Debug function for spewing the scene's docking stack.
RebuildDockingStack[edit]
Clears and rebuilds the complete DockingStack. It is not necessary to manually rebuild the DockingStack when simply adding or removing widgets from the scene, since those types of actions automatically updates the DockingStack.
RegisterTickableObject[edit]
Register an object with the scene so that it receive calls to Tick.
Parameters:
- ObjectToRegister - the object that should be registered with the scene
- InsertIndex - the index [into the array of tickable objects] where the object should be inserted; if not specified, adds the object to the end of the list. Provides callers with a way to e.g. guarantee that they receive the call to tick before some other object in the list.
Returns:
- TRUE if the object was successfully registered with the scene. FALSE if the object was already in the list or an invalid positive index was specified (other than INDEX_NONE).
ResolveDataStore[edit]
Find the data store that has the specified tag. If the data store's tag is SCENE_DATASTORE_TAG, the scene's data store is returned, otherwise searches through the global data stores for a data store with a Tag matching the specified name.
Parameters:
- DataStoreTag - A name corresponding to the 'Tag' property of a data store
- InPlayerOwner - The player owner to use for resolving the datastore. If NULL, the scene's playerowner will be used instead.
Returns:
- a pointer to the data store that has a Tag corresponding to DataStoreTag, or NULL if no data were found with that tag.
ResolveScenePositions[edit]
Iterates through the scene's DockingStack, and evaluates the Position values for each widget owned by this scene into actual pixel values, then stores that result in the widget's RenderBounds field.
SaveSceneDataValues[edit]
Notifies all children of this scene that are bound to writable data stores to publish their values to those data stores.
Parameters:
- bUnbindSubscribers - if TRUE, all data stores bound by widgets and strings in this scene will be unbound.
SetActiveContextMenu[edit]
Changes the scene's ActiveContextMenu to the one specified.
Parameters:
- NewContextMenu - the new context menu to activate, or NULL to clear any active context menus.
- PlayerIndex - the index of the player to display the context menu for.
Returns:
- TRUE if the scene's ActiveContextMenu was successfully changed to the new value.
SetSceneInputMode[edit]
Changes the screen input mode for this scene.
SetSceneRenderMode[edit]
Accessor for changing the value of this scene's SceneRenderMode var.
ShouldRenderParentScenes[edit]
Wrapper for checking whether this scene's parent should also be rendered.
UnbindSubscribers[edit]
Makes all the widgets in this scene unsubscribe from their bound datastores.
UnregisterTickableObject[edit]
Unregisters an object with the scene so that it no longer receives calls to Tick.
Parameters:
- ObjectToRemove - the object that should be removed from the scene's list of tickable objects.
Returns:
- TRUE if the object was successfully removed from the scene.
Events[edit]
AddedChild[edit]
Overrides: UIScreenObject.AddedChild
Called immediately after a child has been added to this screen object.
Parameters:
- WidgetOwner - the screen object that the NewChild was added as a child for
- NewChild - the widget that was added
CalculateInputMask[edit]
Determines the appropriate PlayerInput mask for this scene, based on the scene's input mode.
CloseScene[edit]
Closes the specified scene, optionally activating the scene's closing animation.
Parameters:
- SceneToClose - a reference to the scene instance that should be closed; if not specified, closes this scene.
- bCloseChildScenes - specify FALSE to prevent scenes opened after this one from being automatically closed.
- bForceCloseImmediately - specify TRUE to indicate that the scene's OnQueryCloseSceneAllowed delegate should be ignored. Usually used in cases where you need to ensure the scene goes away immediately, rather than e.g. activating a close animation which would cause the scene to remain active for a few more frames.
Returns:
- TRUE if the scene was closed or the closing animation was activated. FALSE if the scene couldn't be closed and the closing animation wasn't started.
GetFocusHint[edit]
Callback for retrieving the widget that provides hints about which item is currently focused.
Parameters:
- bQueryOnly - specify TRUE to indicate that a focus hint should not be created if it doesn't already exist.
Returns:
- the widget used for displaying the global focused control hint.
OpenScene[edit]
Opens a new instance of a UIScene resource, optionally activating the scene's opening animation as well as the currently active scene's focus-lost animations.
Parameters:
- SceneToOpen - a reference to the scene resource that should be instanced and activated.
- ScenePlayerOwner - the player that should have control of the scene.
- ForcedPriority - overrides the scene's SceneStackPriority value to allow callers to modify where the scene is placed in the stack, by default.
- bSkipAnimation - specify TRUE to indicate that opening animations should be bypassed.
- SceneDelegate - allows the caller to hook into the new scene's OnSceneActivated delegate.
Returns:
- a reference to an instance of the specified scene resource, which is guaranteed to be in the list of active scenes; NULL if the scene couldn't be activated.
RemovedChild[edit]
Overrides: UIScreenObject.RemovedChild
Called immediately after a child has been removed from this screen object.
Parameters:
- WidgetOwner - the screen object that the widget was removed from.
- OldChild - the widget that was removed
- ExclusionSet - used to indicate that multiple widgets are being removed in one batch; useful for preventing references between the widgets being removed from being severed. NOTE: If a value is specified, OldChild will ALWAYS be part of the ExclusionSet, since it is being removed.
SceneActivated[edit]
Called just after the scene is added to the ActiveScenes array, or when this scene has become the active scene as a result of closing another scene.
Parameters:
- bInitialActivation - TRUE if this is the first time this scene is being activated; FALSE if this scene has become active as a result of closing another scene or manually moving this scene in the stack.
SceneDeactivated[edit]
Called just after this scene is removed from the active scenes array
SetVisibility[edit]
Overrides: UIScreenObject.SetVisibility
Changes whether this widget is visible or not. Should be overridden in child classes to perform additional logic or abort the visibility change.
Parameters:
- bIsVisible - TRUE if the widget should be visible; false if not.
UIAnimationEnded[edit]
Overrides: UIScreenObject.UIAnimationEnded
Notification that one or more tracks in an animation sequence have completed.
Parameters:
- Sender - the widget that completed animating.
- AnimName - the name of the animation sequence that completed.
- TypeMask - a bitmask indicating which animation tracks completed. It is generated by left shifting 1 by the values of the EUIAnimType enum. A value of 0 indicates that all tracks in the animation sequence have finished.
UIAnimationStarted[edit]
Overrides: UIScreenObject.UIAnimationStarted
Notification that an animation sequence has been activated.
Parameters:
- Sender - the widget that owns the animation sequence that was activated
- AnimName - the name of the animation sequence that was activated.
- TypeMask - a bitmask indicating which animation tracks were activated. It is generated by left shifting 1 by the values of the EUIAnimType enum. A value of 0 indicates that all tracks in the animation sequence are being activated.
- bSetAnimatingFlag - indicates whether this widget should mark itself as animating.
Other instance functions[edit]
BeginSceneAnimation[edit]
Wrapper function for activating an animation sequence on this widget.
Parameters:
- AnimationSequenceName - the name of the animation sequence to activate; should match the 'SeqName' of one of the UIAnimationSeq objects defined in the game scene client class.
- TrackCompletedDelegate - optional function for receiving a notification when a track in the animation sequence has completed.
Returns:
- TRUE if the animation sequence was triggered successfully.
BeginSceneCloseAnimation[edit]
Wrapper for activating the scene's closing animation.
Returns:
- TRUE if the closing animation was successfully activated.
BeginSceneLostFocusAnimation[edit]
Wrapper for activating the scene's lost-focus animation (this animation is played when a new scene is becoming active).
BeginSceneOpenAnimation[edit]
Wrapper for activating the scene's opening animation.
BeginSceneRegainedFocusAnimation[edit]
Wrapper for activating the scene's reactivate animation, which is played when this scene has just become the top-most scene due to another scene closing.
BeginSceneRegainingFocusAnimation[edit]
Wrapper for activating the scene's regain-focus animation, which is played when the next scene up is the top-most scene and it begins to close
DebugShowAnimators[edit]
FindAnimatorIndex[edit]
Find the index into the array of currently animating child widgets for a child of this scene.
Parameters:
- SearchObj - the widget to find the index for.
Returns:
- the index into the AnimatingObjects array for the specified object, or INDEX_NONE if it isn't in the array.
LogCurrentState[edit]
Overrides: UIScreenObject.LogCurrentState
LogRenderBounds[edit]
NotifyControllerStatusChanged[edit]
Called when a gamepad (or other controller) is inserted or removed)
Parameters:
- ControllerId - the id of the gamepad that was added/removed.
- bConnected - indicates the new status of the gamepad.
NotifyGameSessionEnded[edit]
Called when the current map is being unloaded. Cleans up any references which would prevent garbage collection.
NotifyLinkStatusChanged[edit]
Called when the status of the platform's network connection changes.
NotifyLoginStatusChanged[edit]
Notification that the login status a player has changed.
Parameters:
- ControllerId - the id of the gamepad for the player that changed login status
- NewStatus - the value for the player's current login status
Returns:
- TRUE if this scene wishes to handle the event and prevent further processing.
NotifyOnlineServiceStatusChanged[edit]
Notification that the player's connection to the platform's online service is changed.
NotifyPlayerAdded[edit]
Called when a new player has been added to the list of active players (i.e. split-screen join)
Parameters:
- PlayerIndex - the index [into the GamePlayers array] where the player was inserted
- AddedPlayer - the player that was added
NotifyPlayerRemoved[edit]
Called when a player has been removed from the list of active players (i.e. split-screen players)
Parameters:
- PlayerIndex - the index [into the GamePlayers array] where the player was located
- RemovedPlayer - the player that was removed
NotifyPreClientTravel[edit]
Called when the local player is about to travel to a new URL. This callback should be used to perform any preparation tasks, such as updating status text and such. All cleanup should be done from NotifyGameSessionEnded, as that function will be called in some cases where NotifyClientTravel is not.
Parameters:
- TravelURL - a string containing the mapname (or IP address) to travel to, along with option key/value pairs
- TravelType - indicates whether the player will clear previously added URL options or not.
- bIsSeamless - indicates whether seamless travelling will be used.
NotifyStorageDeviceChanged[edit]
Called when a storage device is inserted or removed.
OnCloseAnimationComplete[edit]
Handler for the completion of this scene's closing animation
Warning: if you override this in a child class, keep in mind that this function will not be called if the scene has no closing animation.
OnCloseAnimationComplete_IgnoreChildScenes[edit]
Handler for the completion of this scene's closing animation
Warning: if you override this in a child class, keep in mind that this function will not be called if the scene has no closing animation.
OnLostFocusAnimationComplete[edit]
Handler for the completion of this scene's lost-focus animation
Warning: if you override this in a child class, keep in mind that this function will not be called if the scene has no lost-focus animation.
OnOpenAnimationComplete[edit]
Handler for the completion of this scene's opening animation...
Warning: if you override this in a child class, keep in mind that this function will not be called if the scene has no opening animation.
OnRegainedFocusAnimationComplete[edit]
Handler for the completion of this scene's re-activated animation
Warning: if you override this in a child class, keep in mind that this function will not be called if the scene has no re-activated animation.
OnRegainingFocusAnimationComplete[edit]
Handler for the completion of this scene's 'becoming active again' animation
Warning: if you override this in a child class, keep in mind that this function will not be called if the scene has no 'becoming active again' animation.
SceneCreated[edit]
Default handler for the OnCreateScene delegate
StopSceneAnimation[edit]
Wrapper for stopping an active UI animtion sequence.
Parameters:
- AnimationSequenceName - the name of the animation sequence to stop; should match the 'SeqName' of one of the UIAnimationSeq objects defined in the game scene client class.
- bFinalize - indicates whether the widget should apply the final frame of the animation (i.e. simulate the animation completing)