UniApplication Object

UniApplication returns an instance of TUniGUIApplication which is the owner of all current session resources (MainForm, MainModule, and all other forms and DataModules). It is globally available and can be accessed inside uniGUI control event handlers. UniApplication has several useful properties which can be used to obtain information regarding the associated session — for example, URL parameters, client screen width, client screen height, device type, information related to the client PC, and cookies.

When creating a form in code, its owner must be set to UniApplication:

Example (Delphi)

procedure TMainForm.UniButton2Click(Sender: TObject);
begin
  with TUniForm2.Create(UniApplication) do
    ShowModal();
end;

UniApplication itself is actually a function which returns the correct instance of TUniGUIApplication for the current session:

Unit Declaration

unit uniGUIApplication;

interface

function UniSession: TUniGUISession;

function UniApplication: TUniGUIApplication;

...

UniApplication should only be accessed inside an event handler which is fired from a uniGUI control (i.e., in the context of a session). Accessing it outside an appropriate event/session context may not return the correct instance.

Example checking platform inside an event handler:

Example (Platform Check)

procedure TMainmForm.UnimButton1Click(Sender: TObject);
begin
  if upAndroid in UniApplication.UniPlatform then
    ShowMessage('This is an Android device!');
end;