XRF X-Ray 16 SDK

Appearance

Class: MockCUIMessageBox ​

Mock generic message box.

Extends ​

Implements ​

  • CUIMessageBox

Accessors ​

__name ​

Get Signature ​

ts
get __name(): string;
Returns ​

string

Implementation of ​

ts
CUIMessageBox.__name

Inherited from ​

MockCUIStatic.__name

__name ​

Get Signature ​

ts
get static __name(): string;
Returns ​

string

Inherited from ​

MockCUIStatic.__name

Constructors ​

Constructor ​

ts
new MockCUIMessageBox(): MockCUIMessageBox;

Returns ​

MockCUIMessageBox

Inherited from ​

MockCUIStatic.constructor

Methods ​

GetHeight() ​

ts
GetHeight(): number;

Returns ​

number

Window height.

Implementation of ​

ts
CUIMessageBox.GetHeight

Inherited from ​

MockCUIStatic.GetHeight

GetWidth() ​

ts
GetWidth(): number;

Returns ​

number

Window width.

Implementation of ​

ts
CUIMessageBox.GetWidth

Inherited from ​

MockCUIStatic.GetWidth

OnKeyboard() ​

ts
OnKeyboard(): boolean;

Returns ​

boolean

Inherited from ​

MockCUIStatic.OnKeyboard

Show() ​

ts
Show(isShown: boolean): void;

Show or hide the window.

Parameters ​

ParameterType
isShownboolean

Returns ​

void

Remarks ​

Visibility does not attach, detach, enable, or disable the window.

Implementation of ​

ts
CUIMessageBox.Show

Inherited from ​

MockCUIStatic.Show

create() ​

ts
static create(): MockCUIMessageBox;

Returns ​

MockCUIMessageBox

Overrides ​

MockCUIStatic.create

mock() ​

ts
static mock(): CUIMessageBox;

Returns ​

CUIMessageBox

Overrides ​

MockCUIStatic.mock

Properties ​

AttachChild ​

ts
AttachChild: Mock<(window: CUIWindow) => void>;

Attach a child window.

Remarks ​

The Lua binding adopts child; after attachment, treat the parent as owning its lifetime.

Param ​

child

Child window.

Implementation of ​

ts
CUIMessageBox.AttachChild

Inherited from ​

MockCUIStatic.AttachChild

children ​

ts
children: CUIWindow[] = [];

Inherited from ​

MockCUIStatic.children

DetachChild ​

ts
DetachChild: Mock<(window: CUIWindow) => void>;

Detach a child window.

Remarks ​

Detaching removes the parent relation. It does not reinitialize the window or attach it elsewhere.

Param ​

child

Child window.

Implementation of ​

ts
CUIMessageBox.DetachChild

Inherited from ​

MockCUIStatic.DetachChild

Enable ​

ts
Enable: Mock<(isEnabled: boolean) => void>;

Enable or disable interaction.

Remarks ​

Enabled state and visibility are separate. Hidden controls can still be enabled.

Param ​

is_enabled

Whether the window should be enabled.

Implementation of ​

ts
CUIMessageBox.Enable

Inherited from ​

MockCUIStatic.Enable

focusReceiveTime ​

ts
focusReceiveTime: number = 0;

Inherited from ​

MockCUIStatic.focusReceiveTime

FocusReceiveTime ​

ts
FocusReceiveTime: Mock<() => number>;

Returns ​

Level time when this window received focus.

Implementation of ​

ts
CUIMessageBox.FocusReceiveTime

Inherited from ​

MockCUIStatic.FocusReceiveTime

GetAbsoluteRect ​

ts
GetAbsoluteRect: Mock<() => Frect>;

Returns ​

Window rectangle in screen coordinates.

Implementation of ​

ts
CUIMessageBox.GetAbsoluteRect

Inherited from ​

MockCUIStatic.GetAbsoluteRect

GetColor ​

ts
GetColor: Mock<() => number>;

Returns ​

Texture color.

Implementation of ​

ts
CUIMessageBox.GetColor

Inherited from ​

MockCUIStatic.GetColor

GetFont ​

ts
GetFont: Mock<() => CGameFont>;

Get the font assigned to this window.

Remarks ​

Text controls need a font assigned before drawing custom text reliably.

Returns ​

Font assigned to this window.

Implementation of ​

ts
CUIMessageBox.GetFont

Inherited from ​

MockCUIStatic.GetFont

GetHeading ​

ts
GetHeading: Mock<() => number>;

Returns ​

Heading angle.

Implementation of ​

ts
CUIMessageBox.GetHeading

Inherited from ​

MockCUIStatic.GetHeading

GetHost ​

ts
GetHost: Mock<() => string>;

Returns ​

Host entered in the message box.

Implementation of ​

ts
CUIMessageBox.GetHost

GetMouseX ​

ts
GetMouseX: Mock<() => number>;

Get cursor X coordinate stored on this window.

Since ​

OpenXRay 2026-01-01, e3b0e3c5, PR #2028

Source ​

src/xrUICore/ui_export_script.cpp, CUIWindow.GetMouseX binding.

Returns ​

Current cursor X coordinate.

Implementation of ​

ts
CUIMessageBox.GetMouseX

Inherited from ​

MockCUIStatic.GetMouseX

GetMouseY ​

ts
GetMouseY: Mock<() => number>;

Get cursor Y coordinate stored on this window.

Since ​

OpenXRay 2026-01-01, e3b0e3c5, PR #2028

Source ​

src/xrUICore/ui_export_script.cpp, CUIWindow.GetMouseY binding.

Returns ​

Current cursor Y coordinate.

Implementation of ​

ts
CUIMessageBox.GetMouseY

Inherited from ​

MockCUIStatic.GetMouseY

GetOriginalRect ​

ts
GetOriginalRect: Mock<() => Frect>;

Returns ​

Original texture rectangle.

Implementation of ​

ts
CUIMessageBox.GetOriginalRect

Inherited from ​

MockCUIStatic.GetOriginalRect

GetPassword ​

ts
GetPassword: Mock<() => string>;

Returns ​

Password entered in the message box.

Implementation of ​

ts
CUIMessageBox.GetPassword

GetStretchTexture ​

ts
GetStretchTexture: Mock<() => boolean>;

Returns ​

Whether texture stretching is enabled.

Implementation of ​

ts
CUIMessageBox.GetStretchTexture

Inherited from ​

MockCUIStatic.GetStretchTexture

GetText ​

ts
GetText: Mock<() => string>;

Returns ​

Current text.

Implementation of ​

ts
CUIMessageBox.GetText

Inherited from ​

MockCUIStatic.GetText

GetTextAlign ​

ts
GetTextAlign: Mock<() => number>;

Returns ​

Text alignment id.

Implementation of ​

ts
CUIMessageBox.GetTextAlign

Inherited from ​

MockCUIStatic.GetTextAlign

GetTextureColor ​

ts
GetTextureColor: Mock<() => number>;

Returns ​

Texture color.

Implementation of ​

ts
CUIMessageBox.GetTextureColor

Inherited from ​

MockCUIStatic.GetTextureColor

GetTextureRect ​

ts
GetTextureRect: Mock<() => Frect>;

Returns ​

Texture rectangle.

Implementation of ​

ts
CUIMessageBox.GetTextureRect

Inherited from ​

MockCUIStatic.GetTextureRect

GetTextX ​

ts
GetTextX: Mock<() => number>;

Returns ​

Text X offset.

Implementation of ​

ts
CUIMessageBox.GetTextX

Inherited from ​

MockCUIStatic.GetTextX

GetTextY ​

ts
GetTextY: Mock<() => number>;

Returns ​

Text Y offset.

Implementation of ​

ts
CUIMessageBox.GetTextY

Inherited from ​

MockCUIStatic.GetTextY

GetWndPos ​

ts
GetWndPos: Mock<() => vector2>;

Returns ​

Window position relative to its parent.

Implementation of ​

ts
CUIMessageBox.GetWndPos

Inherited from ​

MockCUIStatic.GetWndPos

heading ​

ts
heading: number = 0;

Inherited from ​

MockCUIStatic.heading

host ​

ts
host: string = "";

Init ​

ts
Init: Mock<(rectOrX: number | Frect, y?: number, width?: number, height?: number) => void>;

Initialize window rectangle.

Param ​

frect

Window rectangle.

Implementation of ​

ts
CUIMessageBox.Init

Inherited from ​

MockCUIStatic.Init

InitMessageBox ​

ts
InitMessageBox: Mock<() => boolean>;

Initialize message box layout.

Param ​

value

Message box template name.

Returns ​

Whether initialization succeeded.

Implementation of ​

ts
CUIMessageBox.InitMessageBox

InitTexture ​

ts
InitTexture: Mock<(texture: string) => void>;

Assign texture by atlas id.

Param ​

texture

Texture id.

Implementation of ​

ts
CUIMessageBox.InitTexture

Inherited from ​

MockCUIStatic.InitTexture

InitTextureEx ​

ts
InitTextureEx: Mock<(texture: string, shader: string) => void>;

Assign texture and shader by name.

Param ​

first

Texture id.

Param ​

second

Shader id.

Implementation of ​

ts
CUIMessageBox.InitTextureEx

Inherited from ​

MockCUIStatic.InitTextureEx

isAutoDelete ​

ts
isAutoDelete: boolean = false;

Inherited from ​

MockCUIStatic.isAutoDelete

IsAutoDelete ​

ts
IsAutoDelete: Mock<() => boolean>;

Returns ​

Whether the engine owns and deletes this window with its parent.

Implementation of ​

ts
CUIMessageBox.IsAutoDelete

Inherited from ​

MockCUIStatic.IsAutoDelete

IsCursorOverWindow ​

ts
IsCursorOverWindow: Mock<() => boolean>;

Returns ​

Whether the UI cursor is currently over this window.

Implementation of ​

ts
CUIMessageBox.IsCursorOverWindow

Inherited from ​

MockCUIStatic.IsCursorOverWindow

isEnabled ​

ts
isEnabled: boolean = false;

Inherited from ​

MockCUIStatic.isEnabled

IsEnabled ​

ts
IsEnabled: Mock<() => boolean>;

Returns ​

Whether the window accepts interaction.

Implementation of ​

ts
CUIMessageBox.IsEnabled

Inherited from ​

MockCUIStatic.IsEnabled

isPostProcessMode ​

ts
isPostProcessMode: boolean = false;

Inherited from ​

MockCUIStatic.isPostProcessMode

isShown ​

ts
isShown: boolean = false;

Inherited from ​

MockCUIStatic.isShown

IsShown ​

ts
IsShown: Mock<() => boolean>;

Returns ​

Whether the window is visible.

Implementation of ​

ts
CUIMessageBox.IsShown

Inherited from ​

MockCUIStatic.IsShown

mouseX ​

ts
mouseX: number = 0;

Inherited from ​

MockCUIStatic.mouseX

mouseY ​

ts
mouseY: number = 0;

Inherited from ​

MockCUIStatic.mouseY

originalRect ​

ts
originalRect: Frect;

Inherited from ​

MockCUIStatic.originalRect

password ​

ts
password: string = "";

ResetPPMode ​

ts
ResetPPMode: Mock<() => void>;

Disable post-process mode for this window.

Remarks ​

Pair with CUIWindow.SetPPMode when a window no longer needs post-process rendering.

Implementation of ​

ts
CUIMessageBox.ResetPPMode

Inherited from ​

MockCUIStatic.ResetPPMode

SetAutoDelete ​

ts
SetAutoDelete: Mock<(isAutoDelete: boolean) => void>;

Set whether the parent owns this child window.

Remarks ​

Use this for script-created windows that are attached to a parent and should be cleaned up with the UI tree.

Param ​

auto_delete

Whether the engine should delete the child automatically.

Implementation of ​

ts
CUIMessageBox.SetAutoDelete

Inherited from ​

MockCUIStatic.SetAutoDelete

SetColor ​

ts
SetColor: Mock<(color: number) => void>;

Set texture color.

Param ​

color

ARGB color.

Implementation of ​

ts
CUIMessageBox.SetColor

Inherited from ​

MockCUIStatic.SetColor

SetElipsis ​

ts
SetElipsis: Mock<UnknownFunction>;

Configure text ellipsis.

Param ​

a

Ellipsis mode.

Param ​

b

Indent.

Implementation of ​

ts
CUIMessageBox.SetElipsis

Inherited from ​

MockCUIStatic.SetElipsis

SetFont ​

ts
SetFont: Mock<(font: CGameFont) => void>;

Set the font used by this window.

Param ​

font

Font object.

Implementation of ​

ts
CUIMessageBox.SetFont

Inherited from ​

MockCUIStatic.SetFont

SetHeading ​

ts
SetHeading: Mock<(heading: number) => void>;

Set heading angle.

Param ​

number

Heading angle.

Implementation of ​

ts
CUIMessageBox.SetHeading

Inherited from ​

MockCUIStatic.SetHeading

SetHeight ​

ts
SetHeight: Mock<(height: number) => void>;

Set window height.

Param ​

height

New height.

Implementation of ​

ts
CUIMessageBox.SetHeight

Inherited from ​

MockCUIStatic.SetHeight

SetOriginalRect ​

ts
SetOriginalRect: Mock<(rect: Frect) => void>;

Set original texture rectangle.

Param ​

frect

Original rectangle.

Implementation of ​

ts
CUIMessageBox.SetOriginalRect

Inherited from ​

MockCUIStatic.SetOriginalRect

SetPPMode ​

ts
SetPPMode: Mock<() => void>;

Enable post-process mode for this window.

Remarks ​

Use for windows meant to be drawn through the post-process UI path, and reset it when the window returns to normal UI rendering.

Implementation of ​

ts
CUIMessageBox.SetPPMode

Inherited from ​

MockCUIStatic.SetPPMode

SetStretchTexture ​

ts
SetStretchTexture: Mock<(stretch: boolean) => void>;

Enable or disable texture stretching.

Param ​

stretch

Whether texture should stretch to the window rect.

Implementation of ​

ts
CUIMessageBox.SetStretchTexture

Inherited from ​

MockCUIStatic.SetStretchTexture

SetText ​

ts
SetText: Mock<(text: string) => void>;

Set raw text.

Param ​

text

Text value.

Implementation of ​

ts
CUIMessageBox.SetText

Inherited from ​

MockCUIStatic.SetText

SetTextAlign ​

ts
SetTextAlign: Mock<(align: number) => void>;

Set text alignment.

Param ​

align

Alignment id.

Implementation of ​

ts
CUIMessageBox.SetTextAlign

Inherited from ​

MockCUIStatic.SetTextAlign

SetTextColor ​

ts
SetTextColor: Mock<(a: number, r: number, g: number, b: number) => void>;

Set text color from color channels.

Param ​

a

Alpha channel.

Param ​

r

Red channel.

Param ​

g

Green channel.

Param ​

b

Blue channel.

Implementation of ​

ts
CUIMessageBox.SetTextColor

Inherited from ​

MockCUIStatic.SetTextColor

SetTextST ​

ts
SetTextST: Mock<(text: string) => void>;

Set translated string-table text.

Param ​

string

String table id.

Implementation of ​

ts
CUIMessageBox.SetTextST

Inherited from ​

MockCUIStatic.SetTextST

SetTextureColor ​

ts
SetTextureColor: Mock<(color: number) => void>;

Set texture color.

Param ​

color

ARGB color.

Implementation of ​

ts
CUIMessageBox.SetTextureColor

Inherited from ​

MockCUIStatic.SetTextureColor

SetTextureOffset ​

ts
SetTextureOffset: Mock<(x: number, y: number) => void>;

Set texture drawing offset.

Param ​

x

X offset.

Param ​

y

Y offset.

Implementation of ​

ts
CUIMessageBox.SetTextureOffset

Inherited from ​

MockCUIStatic.SetTextureOffset

SetTextureRect ​

ts
SetTextureRect: Mock<(rect: Frect) => void>;

Set source texture rectangle.

Param ​

frect

Texture rectangle.

Implementation of ​

ts
CUIMessageBox.SetTextureRect

Inherited from ​

MockCUIStatic.SetTextureRect

SetTextX ​

ts
SetTextX: Mock<(x: number) => void>;

Set text X offset.

Param ​

x

X offset.

Implementation of ​

ts
CUIMessageBox.SetTextX

Inherited from ​

MockCUIStatic.SetTextX

SetTextY ​

ts
SetTextY: Mock<(y: number) => void>;

Set text Y offset.

Param ​

x

Y offset.

Implementation of ​

ts
CUIMessageBox.SetTextY

Inherited from ​

MockCUIStatic.SetTextY

SetWidth ​

ts
SetWidth: Mock<(width: number) => void>;

Set window width.

Param ​

width

New width.

Implementation of ​

ts
CUIMessageBox.SetWidth

Inherited from ​

MockCUIStatic.SetWidth

SetWindowName ​

ts
SetWindowName: Mock<(name: string) => void>;

Set debug/window name.

Param ​

name

Window name.

Implementation of ​

ts
CUIMessageBox.SetWindowName

Inherited from ​

MockCUIStatic.SetWindowName

SetWndPos ​

ts
SetWndPos: Mock<(positionOrX: number | vector2, y?: number) => void>;

Set window position.

Param ​

vector2

New position.

Implementation of ​

ts
CUIMessageBox.SetWndPos

Inherited from ​

MockCUIStatic.SetWndPos

SetWndRect ​

ts
SetWndRect: Mock<(rectOrX: number | Frect, y?: number, width?: number, height?: number) => void>;

Set window rectangle.

Param ​

rect

New rectangle.

Implementation of ​

ts
CUIMessageBox.SetWndRect

Inherited from ​

MockCUIStatic.SetWndRect

SetWndSize ​

ts
SetWndSize: Mock<(sizeOrWidth: number | vector2, height?: number) => void>;

Set window size.

Param ​

vector2

New size.

Implementation of ​

ts
CUIMessageBox.SetWndSize

Inherited from ​

MockCUIStatic.SetWndSize

shader ​

ts
shader: string | null = null;

Inherited from ​

MockCUIStatic.shader

stretchTexture ​

ts
stretchTexture: boolean = false;

Inherited from ​

MockCUIStatic.stretchTexture

text ​

ts
text: string = "";

Inherited from ​

MockCUIStatic.text

textAlign ​

ts
textAlign: number = 0;

Inherited from ​

MockCUIStatic.textAlign

textColor ​

ts
textColor: number = 0xffffffff;

Inherited from ​

MockCUIStatic.textColor

textControl ​

ts
textControl: CUILines;

Inherited from ​

MockCUIStatic.textControl

TextControl ​

ts
TextControl: Mock<() => CUILines>;

Returns ​

Text line controller.

Implementation of ​

ts
CUIMessageBox.TextControl

Inherited from ​

MockCUIStatic.TextControl

texture ​

ts
texture: string | null = null;

Inherited from ​

MockCUIStatic.texture

textureColor ​

ts
textureColor: number = 0xffffffff;

Inherited from ​

MockCUIStatic.textureColor

textureOffsetX ​

ts
textureOffsetX: number = 0;

Inherited from ​

MockCUIStatic.textureOffsetX

textureOffsetY ​

ts
textureOffsetY: number = 0;

Inherited from ​

MockCUIStatic.textureOffsetY

textureRect ​

ts
textureRect: Frect;

Inherited from ​

MockCUIStatic.textureRect

textX ​

ts
textX: number = 0;

Inherited from ​

MockCUIStatic.textX

textY ​

ts
textY: number = 0;

Inherited from ​

MockCUIStatic.textY

windowFont ​

ts
windowFont: CGameFont | null = null;

Inherited from ​

MockCUIStatic.windowFont

windowName ​

ts
windowName: string | null = null;

Inherited from ​

MockCUIStatic.windowName

WindowName ​

ts
WindowName: Mock<() => string>;

Returns ​

Window name.

Implementation of ​

ts
CUIMessageBox.WindowName

Inherited from ​

MockCUIStatic.WindowName

windowPosition ​

ts
windowPosition: vector2;

Inherited from ​

MockCUIStatic.windowPosition

windowRect ​

ts
windowRect: Frect | null = null;

Inherited from ​

MockCUIStatic.windowRect

windowSize ​

ts
windowSize: vector2;

Inherited from ​

MockCUIStatic.windowSize