Difference between revisions of "Lianja"

From Lianjapedia
Jump to: navigation, search
(Methods)
(Properties)
 
(64 intermediate revisions by 2 users not shown)
Line 31: Line 31:
 
|Currently active App
 
|Currently active App
 
|style="background: green"| 
 
|style="background: green"| 
 +
|style="background: red"| 
 +
|style="background: red"| 
 +
|-
 +
|valign="top"|args
 +
|valign="top"|RW
 +
|valign="top"|Character
 +
|Arguments passed to current App.  From v6.0.
 +
|style="background: green"| 
 +
|style="background: green"| 
 +
|style="background: green"| 
 +
|-
 +
|valign="top"|availablecameralist
 +
|valign="top"|R
 +
|valign="top"|Character
 +
|valign="top"|Comma separated list of available cameras.  From v7.0.
 +
|style="background: lightgreen"| 
 +
|style="background: red"| 
 +
|style="background: red"| 
 +
|-
 +
|valign="top"|availablecameras
 +
|valign="top"|R
 +
|valign="top"|Numeric
 +
|valign="top"|Number of available cameras.  From v7.0.
 +
|style="background: lightgreen"| 
 
|style="background: red"| 
 
|style="background: red"| 
 
|style="background: red"| 
 
|style="background: red"| 
Line 47: Line 71:
 
|valign="top"|Currently active database
 
|valign="top"|Currently active database
 
|style="background: green"| 
 
|style="background: green"| 
|style="background: red"| 
+
|style="background: green"| 
|style="background: red"| 
+
|style="background: green"| 
 
|-
 
|-
 
|valign="top"|Datadir
 
|valign="top"|Datadir
Line 71: Line 95:
 
|valign="top"|Set / unset main window to fullscreen
 
|valign="top"|Set / unset main window to fullscreen
 
|style="text-align: center;background: lightgreen"| 
 
|style="text-align: center;background: lightgreen"| 
 +
|style="background: red"| 
 +
|style="background: red"| 
 +
|-
 +
|valign="top"|leftsidebarvisible
 +
|valign="top"|W
 +
|valign="top"|Boolean
 +
|valign="top"|Set / unset Left SideBar visibility
 +
|style="background: green"| 
 
|style="background: red"| 
 
|style="background: red"| 
 
|style="background: red"| 
 
|style="background: red"| 
Line 143: Line 175:
 
|valign="top"|Set progress bar to the specified value
 
|valign="top"|Set progress bar to the specified value
 
|style="text-align: center;background: lightgreen"| 
 
|style="text-align: center;background: lightgreen"| 
 +
|style="background: red"| 
 +
|style="background: red"| 
 +
|-
 +
|valign="top"|rightsidebarvisible
 +
|valign="top"|W
 +
|valign="top"|Boolean
 +
|valign="top"|Set / unset Right SideBar visibility
 +
|style="background: green"| 
 
|style="background: red"| 
 
|style="background: red"| 
 
|style="background: red"| 
 
|style="background: red"| 
Line 154: Line 194:
 
|style="background: green"| 
 
|style="background: green"| 
 
|-
 
|-
|valign="top"|sidebarvisible
+
|valign="top"|standalone
|valign="top"|W
+
|valign="top"|R
|valign="top"|Boolean (Int)
+
|valign="top"|Boolean
|valign="top"|Set / unset SideBar visibility
+
|valign="top"|Whether the App is running as a [[Standalone Executables on Windows|standalone App]].  From v9.5.
 +
|style="background: green"| 
 +
|style="background: red"| 
 +
|style="background: red"| 
 +
|-
 +
|valign="top"|standalonefilepath
 +
|valign="top"|R
 +
|valign="top"|Character
 +
|valign="top"|Returns the filepath when the App is running as a [[Standalone Executables on Windows|standalone App]].  From v9.5.
 
|style="background: green"| 
 
|style="background: green"| 
 
|style="background: red"| 
 
|style="background: red"| 
Line 175: Line 223:
 
|valign="top"|Set/Get the current App theme
 
|valign="top"|Set/Get the current App theme
 
|style="text-align: center;background: lightgreen"| 
 
|style="text-align: center;background: lightgreen"| 
 +
|style="background: red"| 
 +
|style="background: red"| 
 +
|-
 +
|valign="top"|UIState
 +
|valign="top"|R
 +
|valign="top"|Character
 +
|valign="top"|The last [[UI States|UI State]] applied.
 +
|style="background: green"| 
 
|style="background: red"| 
 
|style="background: red"| 
 
|style="background: red"| 
 
|style="background: red"| 
Line 189: Line 245:
  
 
====Methods====
 
====Methods====
 
+
[[Lianja Methods|Click here for Lianja Methods]]
This class supports the following methods:
+
 
+
{| class="wikitable" width=100%
+
!width="15%"|Method
+
!width="20%"|Args
+
!width="50%"|Description
+
!Desktop||  Web  ||Mobile 
+
|-
+
|valign="top"|addObject
+
|valign="top"|existing as Object | newobject as Character, class as Character [, caption as Character]
+
|valign="top"|Add an existing object or a new object, in which case the object's class must also be specified and optionally its caption
+
|style="background: green"| 
+
|style="background: red"| 
+
|style="background: red"| 
+
|-
+
|valign="top"|AddPage
+
|valign="top"|id as Character,<br>caption as Character
+
|valign="top"|Add a new [[PageBuilder|Page]] with the specified id and caption
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|addProperty
+
|valign="top"|property as Character,<br>value as Expression
+
|valign="top"|Add a property and set its value
+
|style="background: green"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|AddTool
+
|valign="top"|class as Character,<br>caption as Character
+
|valign="top"|Add a tool
+
|style="background: green"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|alert
+
|valign="top"|message as Character
+
|valign="top"|Show the specified message.
+
|style="background: red"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|applyMetaData
+
|valign="top"|None
+
|valign="top"|Apply MetaData to all [[PageBuilder|pages]] in the current App.
+
|style="background: green"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|beep
+
|valign="top"|None
+
|valign="top"|Sounds a 'beep'
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|clearNamedParameters
+
|valign="top"|None
+
|valign="top"|Clear all named parameters previously set using setNamedParameter(name,value).<br>From v5.0.
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|clipBoard
+
|valign="top"|[clipping as Character]
+
|valign="top"|Read from or write to the system clipboard.
+
|style="background: green"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|CloseApp
+
|valign="top"|None
+
|valign="top"|Close the currently open App
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|confirm
+
|valign="top"|message as Character,<br>callback as Function
+
|valign="top"|Show the specified message and pass the result (true|false) to the callback function.
+
|style="background: red"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|Console
+
|valign="top"|output as Character
+
|valign="top"|Write the output string to the Console Output Window
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|CreateApp
+
|valign="top"|app as Character
+
|valign="top"|Create the specified App
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|createCursor
+
|valign="top"|database as Character,<br>table as Character
+
|valign="top"|Return a reference to a [[Cursor]] object for the specified table from the specified database.
+
|style="background: red"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|DeployAppIcon
+
|valign="top"|app as Character,<br>filename as Character<br>[, pagecenter as Logical]
+
|valign="top"|Deploy image file for App or Page Center.
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|evaluate
+
|valign="top"|expression as Character
+
|valign="top"|Evaluate expression. In the LianjaWebFramework, business procedures in custom libraries on the server can also be called.<br>To call a procedure in a library, prefix the procedure name with the library name and '::'<br> var result = Lianja.evaluate("mylib::myproc()");
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|evaluateJavaScript
+
|valign="top"|functioncall as Character
+
|valign="top"|Call server-side JavaScript function and return any result.
+
|style="background: red"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|evaluatePython
+
|valign="top"|functioncall as Character
+
|valign="top"|Call server-side Python function and return any result.
+
|style="background: red"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|execute
+
|valign="top"|command as Character
+
|valign="top"|Execute command
+
|style="background: green"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|FindElementByID
+
|valign="top"|id as Character
+
|valign="top"|Return a reference to the object with the specified id
+
|style="background: green"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|fullPath
+
|valign="top"|filename as Character
+
|valign="top"|Returns the specified file's full path as a character string.  The filename can be prefixed with known locations and will be translated i.e. app:/, lib:/, page lib:/, extensions:/, packages:/, data:/, themes:/, metatypes:/, cloudserver:/, wwwroot:/, images:/. From v5.0.
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|get
+
|valign="top"|id as Character
+
|valign="top"|Return a reference to the object with the specified id
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|GetAppCategories
+
|valign="top"|None
+
|valign="top"|Returns a JSON string of App Categories and the Apps in those Categories
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|GetAppInfo
+
|valign="top"|app as Character
+
|valign="top"|Returns a JSON string of information about the specified App
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|getConnection
+
|valign="top"|None
+
|valign="top"|Return the connection type, e.g. 'WiFi connection'.
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|getCursor
+
|valign="top"|alias as Character
+
|valign="top"|Return a reference to a [[Cursor]] object for the specified table alias
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|getCurrentAcceleration
+
|valign="top"|onSuccess as Function,<br>onError as Function
+
|valign="top"|Return the current acceleration along the x, y, and z axes as an object.
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|GetCurrentLocation
+
|valign="top"|None
+
|valign="top"|Currently unused; returns .F.
+
|style="background: green"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|getCurrentPosition
+
|valign="top"|onSuccess as Function,<br>onError as Function
+
|valign="top"|Return the current position as a position object.
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|getElementByID
+
|valign="top"|id as Character
+
|valign="top"|Return a reference to the object with the specified id
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|getPicture
+
|valign="top"|onSuccess as Function,<br>onError as Function<br>[, cameraOptions as Object]
+
|valign="top"|Take a photo using the camera or retrieve a photo from the device's image gallery.  Returns a file URI or base64 string.  If cameraOptions is not specified, a source selection prompt is displayed and the file URI is returned.
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|getURL
+
|valign="top"|url as character<br>[, username as character, password as character<br>[, filename as character]]
+
|valign="top"|Return a string or, if filename is specified, the file size.  From v5.0.
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|hideDialog
+
|valign="top"|None
+
|valign="top"|Hide the current modal Dialog if one is visible
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|hideDialogPanel
+
|valign="top"|None
+
|valign="top"|Hide the current DialogPanel if one is visible
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|hideMessage
+
|valign="top"|None
+
|valign="top"|Hide the current Message if one is visible
+
|style="background: green"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|HideProgressBar
+
|valign="top"|None
+
|valign="top"|Hide the ProgressBar if one is visible
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|home
+
|valign="top"|None
+
|valign="top"|Return to the App Center
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|isConnected
+
|valign="top"|None
+
|valign="top"|Return logical true if connected, false otherwise.
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|isDevMode
+
|valign="top"|None
+
|valign="top"|Return logical true if on desktop (App Builder or App Center desktop client), false otherwise
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|IsLoadingApp
+
|valign="top"|None
+
|valign="top"|Return logical true if loading App, false otherwise
+
|style="background: green"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|IsKioskMode
+
|valign="top"|None
+
|valign="top"|Return logical true if in kiosk mode, false otherwise
+
|style="background: green"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|isPhoneGap
+
|valign="top"|None
+
|valign="top"|Return logical true if client is mobile device, false otherwise.
+
|style="background: red"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|isRuntimeMode
+
|valign="top"|None
+
|valign="top"|Return logical true if in runtime mode, false otherwise
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|Item
+
|valign="top"|position as Numeric
+
|valign="top"|Return a reference to the [[PageBuilder|Page]] object at the specified position
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|loadAddIns
+
|valign="top"|None
+
|valign="top"|Searches the "Additional file path" and for each of the paths will load a library if a file of the same name as the directory exists. This supports all scripting languages i.e. prg/dbo, js, ts, py, php, esx. From v5.0.
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|loadLibrary
+
|valign="top"|filename as Character
+
|valign="top"|This loads a library and supports all scripting languages i.e. prg/dbo, js, ts, py, php, esx. The fllename can be prefixed with known locations and will be translated i.e. app:/, lib:/, page lib:/, extensions:/, packages:/, data:/, themes:/, metatypes:/, cloudserver:/, wwwroot:/, images:/.<br>When using Lianja.loadLibrary() in development mode any changes to the library are detected and it is reloaded.  Returns logical. From v5.0.
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|loadReport
+
|valign="top"|section_fullname as Character, reportname as Character
+
|valign="top"|This loads the specified existing report into the specified section. From v5.0.
+
|style="text-align: center;background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|Log
+
|valign="top"|logtext as Character
+
|valign="top"|Write the logtext string to the log
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|LogEvent
+
|valign="top"|logtext as Character
+
|valign="top"|Write the logtext string out to the [[Troubleshooter#Performance Metrics|Performance Metrics]] tab in the [[Troubleshooter]].  From v5.0.
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|login
+
|valign="top"|username as Character,<br>password as Character
+
|valign="top"|Log in with the specified username and password.  In the Web and Mobile Clients, the #id selectors #username and #password are used and should be defined before calling Lianja.login().
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|logout
+
|valign="top"|None
+
|valign="top"|Log out and return to the login screen
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|openApp
+
|valign="top"|app as Character
+
|valign="top"|Open the specified App
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|openDatabase
+
|valign="top"|database as Character
+
|valign="top"|Open the specified database and return a Database object reference
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|pauseHttpServer
+
|valign="top"|None
+
|valign="top"|Pause the internal http server.
+
|style="background: green"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|refreshAppInspector
+
|valign="top"|None
+
|valign="top"|Refresh the attributes in the App Inspector and the Page Builder Assistant.<br>Call this after setting attributes programatically.  From v5.0.
+
|style="background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|RemoveObject
+
|valign="top"|existing as Object
+
|valign="top"|Remove the specified object
+
|style="background: green"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|RemovePage
+
|valign="top"|id as Character
+
|valign="top"|Remove the specified [[PageBuilder|Page]]
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|RemoveProperty
+
|valign="top"|property as Character
+
|valign="top"|Remove the specified property
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|RemoveTool
+
|valign="top"|existing as Object
+
|valign="top"|Remove the specified tool
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|resumeHttpServer
+
|valign="top"|None
+
|valign="top"|Resume the internal http server.
+
|style="background: green"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|Run
+
|valign="top"|executable as Character<br>[, args as Character]
+
|valign="top"|Run the specified executable passing the optionally specified comma-separated list of arguments
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|RuntimeCaption
+
|valign="top"|None
+
|valign="top"|Return the runtime caption
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|SelectWorkspace
+
|valign="top"|workspace as Character
+
|valign="top"|Select the specified Workspace
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|SetFocusInSearchBox
+
|valign="top"|None
+
|valign="top"|Set the focus to the Instant Search Box
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|setNamedParameter
+
|valign="top"|name as Character, value as Character
+
|valign="top"|Set the specified named parameter to the specified value. This can be used to set {parameter} or ?parameter macros in [[Virtual Tables|virtual table]] definitions.  From v5.0.
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|setRelationship
+
|valign="top"|page as character,<br>parentSection as character,<br>childSection as character,<br>parentKey as character,<br>childKey as character
+
|valign="top"|Relate two sections. From v5.0.
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|setupUI
+
|valign="top"|None
+
|valign="top"|Execute setupui.prg
+
|style="background: green"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|showDialog
+
|valign="top"|title as Character,<br>page as Character<br>[, width as Numeric<br>[, height as Numeric<br>[, buttons as Numeric<br>[, ontop as Numeric<br>[, modal as Numeric<br>[, action as Character<br>[, text as Character<br>[, resizable as Numeric]]]]]]]]
+
|valign="top"|Pop up a standard dialog and embed the specified page from the page library into it.  For the Web and Mobile Clients, the page must be a .rsp or .jssp script.
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|showDialogPanel
+
|valign="top"|title as Character,<br>page as Character<br>[, width as Numeric<br>[, action as Character<br>[, text as Character]]]
+
|valign="top"|Slide a dialogPanel in from the right of the main window and embed the specified page from the page library into it.    For the Web and Mobile Clients, the page must be a .rsp or .jssp script.  If width is a negative number, the dialogPanel will slide from the left.  Specifying a width of "100%" will animate the dialogPanel in place and it will occupy the whole page viewport (Web client).
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|showDocument
+
|valign="top"|action as Character | filename as Character
+
|valign="top"|Perform a Lianja UI action.  On the desktop, it can also open filename using its file association.  See [[Using the showdocument() function and Lianja.showDocument() method]] for details.
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|showErrorMessage
+
|valign="top"|message as Character<br>[, minimumwidth as Numeric | webtitle as Character]
+
|valign="top"|Show the specified message.  The minimumwidth is supported on the desktop in Lianja/VFP.  If specified, the message stays visible until Lianja.hideMessage() is called. If minimumwidth is > 1 this is the minimum width of the displayed message.  If it is = 1, the message is displayed top right; if < 1, centred.  The webtitle is supported in web/mobile and if specified, is displayed as the title of the message box.
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|ShowHelp
+
|valign="top"|title as Character,<br>tablename as Character<br>[, topic as Character<br>[, showbuttons as Boolean]]
+
|valign="top"|Display help information. The tablename is the name of a table with the structure of:<br>helptopic char(60)<br>helptext memo<br>The table should be indexed on helptopic. For examples, please see the [[SHOWHELP()]] function.
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|showMessage
+
|valign="top"|message as Character<br>[, minimumwidth as Numeric | webtitle as Character]
+
|valign="top"|Show the specified message.  The minimumwidth is supported on the desktop in Lianja/VFP.  If specified, the message stays visible until Lianja.hideMessage() is called. If minimumwidth is > 1 this is the minimum width of the displayed message.  If it is = 1, the message is displayed top right; if < 1, centred.  The webtitle is supported in web/mobile and if specified, is displayed as the title of the message box.
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|showNotification
+
|valign="top"|message as Character,<br>wait as Boolean<br>[, count as Numeric] | [webtitle as Character]
+
|valign="top"|Show the specified notification message. On the desktop, the message is displayed until dismissed by the user if wait is True and the remaining number of notifications can optionally be specified.  The webtitle is supported in web/mobile and if specified, is displayed as the title of the message box.
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|showPagesMenu
+
|valign="top"|None
+
|valign="top"|Show the Pages Menu. This is the same as clicking or touching the "Hamburger" Pages Menu icon. It is most useful in conjunction with gestures in mobile Apps. The equivalent [[SHOWDOCUMENT()|Lianja.showDocument("showpagesmenu")]] can also be used.
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|ShowProgressBar
+
|valign="top"|value as Numeric,<br>maxvalue as Numeric
+
|valign="top"|Shows the ProgressBar at position value with a maximum of maxvalue
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|showQueryBuilder
+
|valign="top"|sectionid as Character,<br>database as Character,<br>table as Character<br>[, columns as Character<br>[, filter as Character<br>[, modal as Boolean<br>[, minbuttons as Boolean]]]]
+
|valign="top"|Pop up a standard dialog and embed the [[QueryBuilder|Query Builder]] in it.  The sectionid should be fully qualified, e.g. "page1.section".  The database and table define the database to use and the table to be queried in the [[QueryBuilder|Query Builder]].  Optionally specify the columns to be included (default is all), a filter expression (use [[OData Operators]]), whether the dialog should be modal (default is false, ignored on non-desktop clients) and whether only the 'Cancel' and 'Done' buttons should be displayed (default is false).
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|showQueryBuilderPanel
+
|valign="top"|sectionid as Character,<br>database as Character,<br>table as Character<br>[, columns as Character<br>[, filter as Character<br>[, position as Character]]]
+
|valign="top"|Slide a dialogPanel in from the right of the main window and embed the [[QueryBuilder|Query Builder]] in it.  The sectionid should be fully qualified, e.g. "page1.section".  The database and table define the database to use and the table to be queried in the [[QueryBuilder|Query Builder]].  Optionally specify the columns to be included (default is all) and a filter expression (use [[OData Operators]]).  On non-desktop clients, the position can be specified as 'left' to slide the dialogPanel in from the left.
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|showQueryPicker
+
|valign="top"|title as Character,<br>onselect as Character,<br>database as Character,<br>table as Character<br>[, parameters as Character]
+
|valign="top"|Slide a dialogPanel in from the right of the main window and embed the [[QueryPicker|Query Picker]].  The database and table define the database to use and the table that will be displayed in the grid.  For details of the parameters, see [[QueryPicker#Query_Picker_Parameters|Query Picker Parameters]].
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|showQueryPickerPanel
+
|valign="top"|title as Character,<br>onselect as Character,<br>database as Character,<br>table as Character<br>[, parameters as Character<br>[, width as Numeric]]
+
|valign="top"|Pop up a standard dialog and embed the [[QueryPicker|Query Picker]].  The database and table define the database to use and the table that will be displayed in the grid.  For details of the parameters, see [[QueryPicker#Query_Picker_Parameters|Query Picker Parameters]].  On non-desktop clients, width determines the width of the dialogPanel.  If it is a negative number, the dialogPanel will slide from the left.  Specifying a width of "100%" will animate the dialogPanel in place and it will occupy the whole page viewport.  The default width is 900 pixels.
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|showSuccessMessage
+
|valign="top"|message as Character<br>[, minimumwidth as Numeric | webtitle as Character]
+
|valign="top"|Show the specified message.  The minimumwidth is supported on the desktop in Lianja/VFP.  If specified, the message stays visible until Lianja.hideMessage() is called. If minimumwidth is > 1 this is the minimum width of the displayed message.  If it is = 1, the message is displayed top right; if < 1, centred.  The webtitle is supported in web/mobile and if specified, is displayed as the title of the message box.
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|Spawn
+
|valign="top"|executable as Character<br>[, args as Character]
+
|valign="top"|Run the specified executable passing the optionally specified comma-separated list of arguments
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|SpawnApp
+
|valign="top"|app as Character
+
|valign="top"|Run the specified App
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|startHttpServer
+
|valign="top"|[port as Numeric]
+
|valign="top"|Start the internal http server, optionally specifying the port number.  The default port is 8002 for the App Builder and 8003 for the App Center.
+
|style="background: green"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|stopHttpServer
+
|valign="top"|None
+
|valign="top"|Stop the internal http server.
+
|style="background: green"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|switchDatabase
+
|valign="top"|name as Character
+
|valign="top"|Switches to the specified database at runtime. This should contain tables with the same name and structure. From v5.0.
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|UnwatchFile
+
|valign="top"|filename as Character |<br>directory as Character
+
|valign="top"|Stop watching the specified file or directory for changes.  Use the WatchFile() method to watch a file/directory.
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|uploadImageFiles
+
|valign="top"|controlsource as Character,<br>[multiple as Boolean,<br>[title as Character,<br>[onsuccess as Function,<br>[onerror as Function]]]]
+
|valign="top"|Displays a file selection dialog popup where the user can select one or more image files. The files are automatically uploaded and a new record (per image file) inserted into the target table on the server in the (blob) column as specified by the controlsource (table.column). The table must be open in the current App.  If the optional multiple is ''true'', multiple files can be selected, if ''false'', only one file can be selected. <br>The optional onsuccess function is passed one argument: a string containing a comma separated list of the files uploaded.  From v5.0.
+
|style="background: red"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|UserDomain
+
|valign="top"|None
+
|valign="top"|Return the domain/tenancy for the current user
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|UserName
+
|valign="top"|None
+
|valign="top"|Return the username for the current user
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|UserRoles
+
|valign="top"|None
+
|valign="top"|Return the roles for the current user
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|Version
+
|valign="top"|None
+
|valign="top"|Return the current Lianja version (HTML formatted)
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|vibrate
+
|valign="top"|seconds as Numeric
+
|valign="top"|On mobile devices, vibrates for the specified number of seconds.  On Web Client, sounds a 'beep'.
+
|style="background: red"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|WatchFile
+
|valign="top"|filename as Character |<br>directory as Character
+
|valign="top"|Watch the specified file or directory for changes.  There is a corresponding [[App Settings#Delegates|App delegate]] called ''filesystemwatcher'' which is called with one argument, the file/directory that has changed.  Use the UnwatchFile() method to stop watching the file/directory.
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|WriteDebug
+
|valign="top"|debugtext as Character
+
|valign="top"|Write the debugtext string to the debug file
+
|style="text-align: center;background: lightgreen"|&nbsp;
+
|style="background: red"|&nbsp;
+
|style="background: red"|&nbsp;
+
|-
+
|valign="top"|writeError
+
|valign="top"|errortext as Character
+
|valign="top"|Write the errortext string to the Console.
+
|style="background: red"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|writeLog
+
|valign="top"|logtext as Character
+
|valign="top"|Write the logtext string to the log (desktop) or JavaScript Console (web/mobile).
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|valign="top"|writeOutput
+
|valign="top"|output as Character
+
|valign="top"|Write the output string to the Output Window (desktop) or JavaScript Console (web/mobile).
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|style="background: green"|&nbsp;
+
|-
+
|}
+
  
 
====Key====
 
====Key====

Latest revision as of 06:43, 20 March 2024

Properties

This class supports the following properties:

Property Access Value Description Desktop   Web   Mobile 
activepage RW Object Return an object reference to the currently active Page      
Appdir R Character Full path of the current App directory      
application R Character Currently active App      
args RW Character Arguments passed to current App. From v6.0.      
availablecameralist R Character Comma separated list of available cameras. From v7.0.      
availablecameras R Numeric Number of available cameras. From v7.0.      
Count R Numeric Number of Pages in the current App      
database R Character Currently active database      
Datadir R Character Full path of the current database directory      
editor R Object Return an object reference to the Editor      
Fullscreen W Boolean (Int) Set / unset main window to fullscreen      
leftsidebarvisible W Boolean Set / unset Left SideBar visibility      
Libdir R Character Full path of the current library directory      
LockScreen W Boolean Lock screen, disabling screen updates      
localStorage R Object Return an object reference to the currently active LocalStorage      
Maximized W Boolean (Int) Set / unset main window to maximized      
Minimized W Boolean (Int) Set / unset main window to minimized      
ProgressLabel W Character Progress bar text label      
ProgressMaximum W Int Progress bar maximum value      
ProgressMinimum W Int Progress bar minimum value      
ProgressValue W Int Set progress bar to the specified value      
rightsidebarvisible W Boolean Set / unset Right SideBar visibility      
sessionStorage R Object Return an object reference to the currently active SessionStorage      
standalone R Boolean Whether the App is running as a standalone App. From v9.5.      
standalonefilepath R Character Returns the filepath when the App is running as a standalone App. From v9.5.      
table R Character Currently active table      
Theme RW Character Set/Get the current App theme      
UIState R Character The last UI State applied.      
version R Character Software version      

Methods

Click here for Lianja Methods

Key

  Supported on this client.
Note that for the web/mobile client, this applies to client-side code. The Lianja system object is not available in server-side functions and procedures.
  Supported in Lianja/VFP scripting only on this client.
 
  Not currently supported on this client.