Your DesktopX Documentation Resource Guide

Documentation Home

Quick Start

User's Guide

Developer's Guide

Resources

Tutorials

DesktopX namespace

These allow you to refer to the DesktopX environment, the objects within in and also the DesktopX application itself.

DesktopX.Object, DesktopX.ScriptObject

You use these two items to refer to objects other than the current one. You should use the first for non scripted objects.

Examples:

DesktopX.Object("mytextobject").Text = “Hello”
DesktopX.Object("otherobject").Top = Object.Bottom

If the object is scripted however, you need to identify whether you are referring to the object itself or the control contained within.

Examples:

DesktopX.ScriptObject("scr_textobject").Object.Text = “Hello”
DesktopX.ScriptObject("scr_textcontrol").Object.Left = 300
DesktopX.ScriptObject("scr_textcontrol").Control.Text = “Type”

DesktopX.IsObject

This allows you to query the existence of another object in the theme which you may choose to do before you interact with it, because it could have been deleted.

Example:

Sub Object_OnScriptEnter
If DesktopX.IsObject("textobj") = False Then
Msgbox "Sorry – important data is missing!"
End If
End Sub

DesktopX.ExecutableDirectory (only for Pro apps)

If you are running DesktopX Pro, then the created EXE may be running from any location, so it is sometimes useful to know where this is. DesktopX.ExecutableDirectory will return this directory.

DesktopX.HostType

Returns the host that is currently running the object. Return values are:

1 – DesktopX Client
2 – DesktopX Builder
3 – Widget runtime
4 – DesktopX PRO application
0 – Unknow

DesktopX.GarbageCollection

It swaps out unused memory. Useful after using some COM object, ActiveX object, graphics, etc that's not going to be used often anymore until unload.

DesktopX.Exit(params)

It quits DesktopX, current widget or gadget. Params is currently unused. Set to 0.

DesktopX.MsgBox(msg, flags, title, owner)

Zorder and thread-friendly Msgbox replacement.
Msg is the actual messagebox content.
Flags contains standard flags. See MS Win32 SDK here: http://msdn.microsoft.com/library/default.asp?url=/library/en-us/winui/winui/
windowsuserinterface/windowing/dialogboxes/dialogboxreference/
dialogboxfunctions/messagebox.asp
Title contains the caption string and owner the owner object name (used to fix the messagebox zorder).