Gah - a solution with more questions. – EntropicLqd

UE3:UIRoot (UT3)

From Unreal Wiki, The Unreal Engine Documentation Site
Jump to: navigation, search
UT3 Object >> UIRoot
Package: 
Engine
Direct subclasses:
UIStyle_Data, UIEditorOptions, Interaction, UIInputConfiguration, UIScreenObject, DataStoreClient, UIAnimation, UIDataProvider, UILayerBase, UISceneClient, UIState, UIString, UIStyle, UITexture
This class in other games:
UDK

Base class for all classes that handle interacting with the user.

Copyright 1998-2007 Epic Games, Inc. All Rights Reserved

Constants[edit]

TEMP_SPLITSCREEN_INDEX[edit]

Value: 0


PRIVATE_NotEditorSelectable[edit]

Value: 0x001

Controls what types of interactions are allowed for a widget. Ideally this would be an enum, but the values are used as a bitmask (for UIObject.PrivateFlags) and unrealscript enums cannot be assigned values.

PRIVATE_TreeHidden[edit]

Value: 0x002

Not selectable in the scene editor.

PRIVATE_NotFocusable[edit]

Value: 0x004

Not viewable in the scene tree or layer tree, but children are.

PRIVATE_NotDockable[edit]

Value: 0x008

Not eligible to receive focus; affects both editor and game

PRIVATE_NotRotatable[edit]

Value: 0x010

Not able to be docked to another widget.

PRIVATE_ManagedStyle[edit]

Value: 0x020

Not able to be rotated.

Todo: not yet implemented.

PRIVATE_TreeHiddenRecursive[edit]

Value: 0x042

Indicates that this widget's styles are managed by its owner widgets - any style references set for this widget will not be saved.

PRIVATE_EditorNoDelete[edit]

Value: 0x080

Not visible in the scene tree or layer tree, including children

PRIVATE_EditorNoRename[edit]

Value: 0x100

This widget is not deletable in the editor

PRIVATE_EditorNoReparent[edit]

Value: 0x200

This widget is not renamable in the editor

PRIVATE_PropagateState[edit]

Value: 0x400

This widget can not be reparented in the editor

PRIVATE_KeepFocusedState[edit]

Value: 0x800

This widget will propagate certain states to its children, such as enabled and disabled

PRIVATE_Protected[edit]

Value: 0x380

Combination flags

ASPECTRATIO_Normal[edit]

Value: 1.333333f

Aspect ratios

ASPECTRATIO_Monitor[edit]

Value: 1.25f


ASPECTRATIO_Widescreen[edit]

Value: 1.777778f


DEFAULT_SIZE_X[edit]

Value: 1024


DEFAULT_SIZE_Y[edit]

Value: 768


SCENE_DATASTORE_TAG[edit]

Value: 'SceneData'


MAX_SUPPORTED_GAMEPADS[edit]

Value: 4


Enums[edit]

See UIRoot enums.

Structs[edit]

See UIRoot structs.

Functions[edit]

Static native functions[edit]

GetCurrentUIController[edit]

native static final noexport function UIInteraction GetCurrentUIController ()

Returns the UIInteraction instance currently controlling the UI system, which is valid in game.

Returns:

a pointer to the UIInteraction object currently controlling the UI system.

GetCursorPosition[edit]

native static final noexport function bool GetCursorPosition (out int CursorX, out int CursorY, const optional UIScene Scene)

Returns the current position of the mouse or joystick cursor.

Parameters:

  • CursorX - receives the X position of the cursor
  • CursorY - receives the Y position of the cursor
  • Scene - if specified, provides access to an FViewport through the scene's SceneClient that can be used for retrieving the mouse position when not in the game.

Returns:

TRUE if the cursor position was retrieved correctly.

GetCursorSize[edit]

native static final noexport function bool GetCursorSize (out float CursorXL, out float CursorYL)

Returns the current position of the mouse or joystick cursor.

Parameters:

  • CursorXL - receives the width of the cursor
  • CursorYL - receives the height of the cursor

Returns:

TRUE if the cursor size was retrieved correctly.

GetDataStoreFieldValue[edit]

native static final function bool GetDataStoreFieldValue (string InDataStoreMarkup, out UIProviderFieldValue OutFieldValue, optional UIScene OwnerScene, optional LocalPlayer OwnerPlayer)

Gets the field value struct of the datastore entry specified.

Parameters:

  • InDataStoreMarkup - Markup to find the field we want to retrieve the value of.
  • OutFieldValue - Variable to store the result field value in.
  • OwnerScene - Owner scene for the datastore, used when dealing with scene specific datastores.
  • OwnerPlayer - Owner player for the datastore, used when dealing with player datastores.

Returns:

TRUE if the value was retrieved, FALSE otherwise.

GetFaceOrientation[edit]

native static final noexport function EUIOrientation GetFaceOrientation (EUIWidgetFace Face)

Wrapper for returns the orientation associated with the specified face.

Note: noexport because the C++ version is static too.

GetPrimitiveTransform[edit]

native static final noexport function Object.Matrix GetPrimitiveTransform (UIObject Widget, optional bool bIncludeAnchorPosition, optional bool bIncudeRotation, optional bool bIncludeScale) const

Returns a matrix which includes the translation, rotation and scale necessary to transform a point from origin to the the specified widget's position onscreen. This matrix can then be passed to ConditionalUpdateTransform() for primitives in use by the UI.

Parameters:

  • Widget - the widget to generate the matrix for
  • bIncludeAnchorPosition - specify TRUE to include translation to the widget's anchor; if FALSE, the translation will move the point to the widget's upper left corner (in local space)
  • bIncludeRotation - specify FALSE to remove the widget's rotation from the resulting matrix
  • bIncludeScale - specify FALSE to remove the viewport's scale from the resulting matrix

Returns:

a matrix which can be used to translate from origin (0,0) to the widget's position, including rotation and viewport scale.

Note: noexport because we want this method to be static in C++ as well.

GetSceneClient[edit]

native static final noexport function GameUISceneClient GetSceneClient ()

Returns the game's scene client.

Returns:

a pointer to the UGameUISceneClient instance currently managing the scenes for the UI System.

SetDataStoreFieldValue[edit]

native static final function bool SetDataStoreFieldValue (string InDataStoreMarkup, const out UIProviderFieldValue InFieldValue, optional UIScene OwnerScene, optional LocalPlayer OwnerPlayer)

Sets the string value of the datastore entry specified.

Parameters:

  • InDataStoreMarkup - Markup to find the field we want to set the value of.
  • InFieldValue - Value to set the datafield's value to.
  • OwnerScene - Owner scene for the datastore, used when dealing with scene specific datastores.
  • OwnerPlayer - Owner player for the datastore, used when dealing with player datastores.

Returns:

TRUE if the value was set, FALSE otherwise.

SetMouseCaptureOverride[edit]

native static final noexport function SetMouseCaptureOverride (bool bCaptureMouse)

Changes the value of GameViewportClient.bUIMouseCaptureOverride to the specified value. Used by widgets that process dragging to ensure that the widget receives the mouse button release event.

Parameters:

  • bCaptureMouse - whether to capture all mouse input.

Other static functions[edit]

ConvertWidgetIDToString[edit]

static final function string ConvertWidgetIDToString (UIObject SourceWidget)

Generates a unique tag that can be used in the scene's data store as the data field name for a widget's context menu items.

Parameters:

  • SourceWidget - the widget to generate the unique tag for

Returns:

a string guaranteed to be unique which represents the source widget.

GetDataStoreStringValue[edit]

static function bool GetDataStoreStringValue (string InDataStoreMarkup, out string OutStringValue, optional UIScene OwnerScene, optional LocalPlayer OwnerPlayer)

Gets the string value of the datastore entry specified.

Parameters:

  • InDataStoreMarkup - Markup to find the field we want to retrieve the value of.
  • OutStringValue - Variable to store the result string in.
  • OwnerScene - Owner scene for the datastore, used when dealing with scene specific datastores.
  • OwnerPlayer - Owner player for the datastore, used when dealing with player datastores.

Returns:

TRUE if the value was retrieved, FALSE otherwise.

IsConsole[edit]

static final function bool IsConsole (optional WorldInfo.EConsoleType ConsoleType)

Returns:

Returns the current platform the game is running on.

SetDataStoreStringValue[edit]

static function bool SetDataStoreStringValue (string InDataStoreMarkup, string InStringValue, optional UIScene OwnerScene, optional LocalPlayer OwnerPlayer)

Sets the string value of the datastore entry specified.

Parameters:

  • InDataStoreMarkup - Markup to find the field we want to set the value of.
  • InStringValue - Value to set the datafield's string value to.
  • OwnerScene - Owner scene for the datastore, used when dealing with scene specific datastores.
  • OwnerPlayer - Owner player for the datastore, used when dealing with player datastores.

Returns:

TRUE if the value was set, FALSE otherwise.