NativeScript 9.1 Released → V8 14.9, Vite 8 HMR, built for rapid agentic visual iteration
Dig in

Defined in: application/application-common.ts

Extended by

Properties

_windows

ts
protected _windows: NativeWindow[];

Defined in: application/application-common.ts


backgroundEvent

ts
readonly backgroundEvent: "background" = "background";

Defined in: application/application-common.ts


cssChangedEvent

ts
readonly cssChangedEvent: "cssChanged" = "cssChanged";

Defined in: application/application-common.ts


discardedErrorEvent

ts
readonly discardedErrorEvent: "discardedError" = "discardedError";

Defined in: application/application-common.ts


displayedEvent

ts
readonly displayedEvent: "displayed" = "displayed";

Defined in: application/application-common.ts


exitEvent

ts
readonly exitEvent: "exit" = "exit";

Defined in: application/application-common.ts

On Android, raised when the last window closes; the process may stay alive. On iOS, raised when the process itself terminates.


fontScaleChangedEvent

ts
readonly fontScaleChangedEvent: "fontScaleChanged" = "fontScaleChanged";

Defined in: application/application-common.ts


foregroundEvent

ts
readonly foregroundEvent: "foreground" = "foreground";

Defined in: application/application-common.ts


hasListeners

ts
hasListeners: (eventName: string) => boolean;

Defined in: application/application-common.ts

Parameters

ParameterType
eventNamestring

Returns

boolean


initRootViewEvent

ts
readonly initRootViewEvent: "initRootView" = "initRootView";

Defined in: application/application-common.ts


launchEvent

ts
readonly launchEvent: "launch" = "launch";

Defined in: application/application-common.ts

Deprecated

Use the 'ready' event for application initialization and Application.setWindowContentResolver() to provide window UI. 'launch' continues to fire before the first window's content is created, and its 'root' property is still honored, for backwards compatibility. It never fires for additional windows. In a scene-based app it fires with the first window's content, so a background launch that connects no scene does not raise it.


layoutDirectionChangedEvent

ts
readonly layoutDirectionChangedEvent: "layoutDirectionChanged" = "layoutDirectionChanged";

Defined in: application/application-common.ts


livesyncEvent

ts
readonly livesyncEvent: "livesync" = "livesync";

Defined in: application/application-common.ts


loadAppCssEvent

ts
readonly loadAppCssEvent: "loadAppCss" = "loadAppCss";

Defined in: application/application-common.ts


lowMemoryEvent

ts
readonly lowMemoryEvent: "lowMemory" = "lowMemory";

Defined in: application/application-common.ts


mainEntry

ts
protected mainEntry: NavigationEntry;

Defined in: application/application-common.ts


notify

ts
notify: <T>(eventData: T) => void;

Defined in: application/application-common.ts

Type Parameters

Type ParameterDefault type
TApplicationEventData

Parameters

ParameterType
eventDataT

Returns

void


off

ts
off: (eventNames: string, callback?: any, thisArg?: any) => void;

Defined in: application/application-common.ts

Parameters

ParameterType
eventNamesstring
callback?any
thisArg?any

Returns

void


on

ts
on: {
  (eventNames: string, callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "cssChanged", callback: (args: CssChangedEventData) => void, thisArg?: any): void;
  (event: "livesync", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "launch", callback: (args: LaunchEventData) => void, thisArg?: any): void;
  (event: "ready", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "displayed", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "suspend", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "resume", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "exit", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "lowMemory", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "uncaughtError", callback: (args: UnhandledErrorEventData) => void, thisArg?: any): void;
  (event: "discardedError", callback: (args: DiscardedErrorEventData) => void, thisArg?: any): void;
  (event: "orientationChanged", callback: (args: OrientationChangedEventData) => void, thisArg?: any): void;
  (event: "systemAppearanceChanged", callback: (args: SystemAppearanceChangedEventData) => void, thisArg?: any): void;
  (event: "layoutDirectionChanged", callback: (args: LayoutDirectionChangedEventData) => void, thisArg?: any): void;
  (event: "fontScaleChanged", callback: (args: FontScaleChangedEventData) => void, thisArg?: any): void;
  (event: "windowOpen", callback: (args: WindowOpenEventData) => void, thisArg?: any): void;
  (event: "windowClose", callback: (args: WindowCloseEventData) => void, thisArg?: any): void;
  (event: "primaryWindowChanged", callback: (args: PrimaryWindowChangedEventData) => void, thisArg?: any): void;
  (event: "sceneOpenURLContexts", callback: (args: SceneOpenURLContextsEventData) => void, thisArg?: any): void;
  (event: "sceneContinueUserActivity", callback: (args: SceneContinueUserActivityEventData) => void, thisArg?: any): void;
  (event: "scenePerformActionForShortcutItem", callback: (args: ScenePerformActionForShortcutItemEventData) => void, thisArg?: any): void;
};

Defined in: application/application-common.ts

Call Signature

ts
(
   eventNames: string, 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
eventNamesstring
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "cssChanged", 
   callback: (args: CssChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when application css is changed.

Parameters
ParameterType
event"cssChanged"
callback(args: CssChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "livesync", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

Event raised then livesync operation is performed.

Parameters
ParameterType
event"livesync"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "launch", 
   callback: (args: LaunchEventData) => void, 
   thisArg?: any): void;

This event is raised on application launchEvent.

Parameters
ParameterType
event"launch"
callback(args: LaunchEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "ready", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised once the JS context is initialized.

Parameters
ParameterType
event"ready"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "displayed", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

Experimental

This event is raised after the application has performed most of its startup actions. Its intent is to be suitable for measuring app startup times.

Parameters
ParameterType
event"displayed"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "suspend", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is suspended.

Parameters
ParameterType
event"suspend"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "resume", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is resumed after it has been suspended.

Parameters
ParameterType
event"resume"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "exit", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is about to exit.

On Android it is raised when the last window closes; the process may stay alive. On iOS it is raised when the process itself terminates.

Parameters
ParameterType
event"exit"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "lowMemory", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when there is low memory on the target device.

Parameters
ParameterType
event"lowMemory"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "uncaughtError", 
   callback: (args: UnhandledErrorEventData) => void, 
   thisArg?: any): void;

This event is raised when an uncaught error occurs while the application is running.

Parameters
ParameterType
event"uncaughtError"
callback(args: UnhandledErrorEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "discardedError", 
   callback: (args: DiscardedErrorEventData) => void, 
   thisArg?: any): void;

This event is raised when an discarded error occurs while the application is running.

Parameters
ParameterType
event"discardedError"
callback(args: DiscardedErrorEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "orientationChanged", 
   callback: (args: OrientationChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the orientation of the application changes.

Parameters
ParameterType
event"orientationChanged"
callback(args: OrientationChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "systemAppearanceChanged", 
   callback: (args: SystemAppearanceChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the operating system appearance changes between light and dark theme (for Android); between light and dark mode (for iOS) and vice versa.

Parameters
ParameterType
event"systemAppearanceChanged"
callback(args: SystemAppearanceChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "layoutDirectionChanged", 
   callback: (args: LayoutDirectionChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the operating system layout direction changes between ltr and rtl.

Parameters
ParameterType
event"layoutDirectionChanged"
callback(args: LayoutDirectionChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "fontScaleChanged", 
   callback: (args: FontScaleChangedEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"fontScaleChanged"
callback(args: FontScaleChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "windowOpen", 
   callback: (args: WindowOpenEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"windowOpen"
callback(args: WindowOpenEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "windowClose", 
   callback: (args: WindowCloseEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"windowClose"
callback(args: WindowCloseEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "primaryWindowChanged", 
   callback: (args: PrimaryWindowChangedEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"primaryWindowChanged"
callback(args: PrimaryWindowChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "sceneOpenURLContexts", 
   callback: (args: SceneOpenURLContextsEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"sceneOpenURLContexts"
callback(args: SceneOpenURLContextsEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "sceneContinueUserActivity", 
   callback: (args: SceneContinueUserActivityEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"sceneContinueUserActivity"
callback(args: SceneContinueUserActivityEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "scenePerformActionForShortcutItem", 
   callback: (args: ScenePerformActionForShortcutItemEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"scenePerformActionForShortcutItem"
callback(args: ScenePerformActionForShortcutItemEventData) => void
thisArg?any
Returns

void


once

ts
once: {
  (eventNames: string, callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "cssChanged", callback: (args: CssChangedEventData) => void, thisArg?: any): void;
  (event: "livesync", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "launch", callback: (args: LaunchEventData) => void, thisArg?: any): void;
  (event: "ready", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "displayed", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "suspend", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "resume", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "exit", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "lowMemory", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "uncaughtError", callback: (args: UnhandledErrorEventData) => void, thisArg?: any): void;
  (event: "discardedError", callback: (args: DiscardedErrorEventData) => void, thisArg?: any): void;
  (event: "orientationChanged", callback: (args: OrientationChangedEventData) => void, thisArg?: any): void;
  (event: "systemAppearanceChanged", callback: (args: SystemAppearanceChangedEventData) => void, thisArg?: any): void;
  (event: "layoutDirectionChanged", callback: (args: LayoutDirectionChangedEventData) => void, thisArg?: any): void;
  (event: "fontScaleChanged", callback: (args: FontScaleChangedEventData) => void, thisArg?: any): void;
  (event: "windowOpen", callback: (args: WindowOpenEventData) => void, thisArg?: any): void;
  (event: "windowClose", callback: (args: WindowCloseEventData) => void, thisArg?: any): void;
  (event: "primaryWindowChanged", callback: (args: PrimaryWindowChangedEventData) => void, thisArg?: any): void;
  (event: "sceneOpenURLContexts", callback: (args: SceneOpenURLContextsEventData) => void, thisArg?: any): void;
  (event: "sceneContinueUserActivity", callback: (args: SceneContinueUserActivityEventData) => void, thisArg?: any): void;
  (event: "scenePerformActionForShortcutItem", callback: (args: ScenePerformActionForShortcutItemEventData) => void, thisArg?: any): void;
};

Defined in: application/application-common.ts

Call Signature

ts
(
   eventNames: string, 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
eventNamesstring
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "cssChanged", 
   callback: (args: CssChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when application css is changed.

Parameters
ParameterType
event"cssChanged"
callback(args: CssChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "livesync", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

Event raised then livesync operation is performed.

Parameters
ParameterType
event"livesync"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "launch", 
   callback: (args: LaunchEventData) => void, 
   thisArg?: any): void;

This event is raised on application launchEvent.

Parameters
ParameterType
event"launch"
callback(args: LaunchEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "ready", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised once the JS context is initialized.

Parameters
ParameterType
event"ready"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "displayed", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

Experimental

This event is raised after the application has performed most of its startup actions. Its intent is to be suitable for measuring app startup times.

Parameters
ParameterType
event"displayed"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "suspend", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is suspended.

Parameters
ParameterType
event"suspend"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "resume", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is resumed after it has been suspended.

Parameters
ParameterType
event"resume"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "exit", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is about to exit.

On Android it is raised when the last window closes; the process may stay alive. On iOS it is raised when the process itself terminates.

Parameters
ParameterType
event"exit"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "lowMemory", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when there is low memory on the target device.

Parameters
ParameterType
event"lowMemory"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "uncaughtError", 
   callback: (args: UnhandledErrorEventData) => void, 
   thisArg?: any): void;

This event is raised when an uncaught error occurs while the application is running.

Parameters
ParameterType
event"uncaughtError"
callback(args: UnhandledErrorEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "discardedError", 
   callback: (args: DiscardedErrorEventData) => void, 
   thisArg?: any): void;

This event is raised when an discarded error occurs while the application is running.

Parameters
ParameterType
event"discardedError"
callback(args: DiscardedErrorEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "orientationChanged", 
   callback: (args: OrientationChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the orientation of the application changes.

Parameters
ParameterType
event"orientationChanged"
callback(args: OrientationChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "systemAppearanceChanged", 
   callback: (args: SystemAppearanceChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the operating system appearance changes between light and dark theme (for Android); between light and dark mode (for iOS) and vice versa.

Parameters
ParameterType
event"systemAppearanceChanged"
callback(args: SystemAppearanceChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "layoutDirectionChanged", 
   callback: (args: LayoutDirectionChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the operating system layout direction changes between ltr and rtl.

Parameters
ParameterType
event"layoutDirectionChanged"
callback(args: LayoutDirectionChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "fontScaleChanged", 
   callback: (args: FontScaleChangedEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"fontScaleChanged"
callback(args: FontScaleChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "windowOpen", 
   callback: (args: WindowOpenEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"windowOpen"
callback(args: WindowOpenEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "windowClose", 
   callback: (args: WindowCloseEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"windowClose"
callback(args: WindowCloseEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "primaryWindowChanged", 
   callback: (args: PrimaryWindowChangedEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"primaryWindowChanged"
callback(args: PrimaryWindowChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "sceneOpenURLContexts", 
   callback: (args: SceneOpenURLContextsEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"sceneOpenURLContexts"
callback(args: SceneOpenURLContextsEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "sceneContinueUserActivity", 
   callback: (args: SceneContinueUserActivityEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"sceneContinueUserActivity"
callback(args: SceneContinueUserActivityEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "scenePerformActionForShortcutItem", 
   callback: (args: ScenePerformActionForShortcutItemEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"scenePerformActionForShortcutItem"
callback(args: ScenePerformActionForShortcutItemEventData) => void
thisArg?any
Returns

void


orientationChangedEvent

ts
readonly orientationChangedEvent: "orientationChanged" = "orientationChanged";

Defined in: application/application-common.ts


primaryWindowChangedEvent

ts
readonly primaryWindowChangedEvent: "primaryWindowChanged";

Defined in: application/application-common.ts


readyEvent

ts
readonly readyEvent: "ready" = "ready";

Defined in: application/application-common.ts

Raised once per JS context, as soon as the context is initialized. It is never deferred, so it also fires on a background launch where no window is created.

Guaranteed ordering: ready -> windowOpen -> raw connect/create events -> content resolution (the legacy launch bridge runs here, for the first window only) -> contentLoaded -> activate/displayed.


resumeEvent

ts
readonly resumeEvent: "resume" = "resume";

Defined in: application/application-common.ts


started

ts
started: boolean;

Defined in: application/application-common.ts


suspendEvent

ts
readonly suspendEvent: "suspend" = "suspend";

Defined in: application/application-common.ts

Reflects whole-app state: with multiple windows it is raised once the app itself is no longer in the foreground, not when an individual window backgrounds. Listen on a NativeWindow for per-window state.


systemAppearanceChangedEvent

ts
readonly systemAppearanceChangedEvent: "systemAppearanceChanged" = "systemAppearanceChanged";

Defined in: application/application-common.ts


uncaughtErrorEvent

ts
readonly uncaughtErrorEvent: "uncaughtError" = "uncaughtError";

Defined in: application/application-common.ts


windowCloseEvent

ts
readonly windowCloseEvent: "windowClose";

Defined in: application/application-common.ts


windowOpenEvent

ts
readonly windowOpenEvent: "windowOpen";

Defined in: application/application-common.ts


hasListeners

ts
static hasListeners: (eventName: string) => boolean;

Defined in: application/application-common.ts

Parameters

ParameterType
eventNamestring

Returns

boolean

Deprecated

Use Application.android.hasListeners() instead.


notify

ts
static notify: <T>(eventData: T) => void;

Defined in: application/application-common.ts

Type Parameters

Type ParameterDefault type
TApplicationEventData

Parameters

ParameterType
eventDataT

Returns

void

Deprecated

Use Application.android.notify() instead.


off

ts
static off: (eventNames: string, callback?: any, thisArg?: any) => void;

Defined in: application/application-common.ts

Parameters

ParameterType
eventNamesstring
callback?any
thisArg?any

Returns

void

Deprecated

Use Application.android.off() instead.


on

ts
static on: {
  (eventNames: string, callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "cssChanged", callback: (args: CssChangedEventData) => void, thisArg?: any): void;
  (event: "livesync", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "launch", callback: (args: LaunchEventData) => void, thisArg?: any): void;
  (event: "ready", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "displayed", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "suspend", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "resume", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "exit", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "lowMemory", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "uncaughtError", callback: (args: UnhandledErrorEventData) => void, thisArg?: any): void;
  (event: "discardedError", callback: (args: DiscardedErrorEventData) => void, thisArg?: any): void;
  (event: "orientationChanged", callback: (args: OrientationChangedEventData) => void, thisArg?: any): void;
  (event: "systemAppearanceChanged", callback: (args: SystemAppearanceChangedEventData) => void, thisArg?: any): void;
  (event: "layoutDirectionChanged", callback: (args: LayoutDirectionChangedEventData) => void, thisArg?: any): void;
  (event: "fontScaleChanged", callback: (args: FontScaleChangedEventData) => void, thisArg?: any): void;
  (event: "windowOpen", callback: (args: WindowOpenEventData) => void, thisArg?: any): void;
  (event: "windowClose", callback: (args: WindowCloseEventData) => void, thisArg?: any): void;
  (event: "primaryWindowChanged", callback: (args: PrimaryWindowChangedEventData) => void, thisArg?: any): void;
  (event: "sceneOpenURLContexts", callback: (args: SceneOpenURLContextsEventData) => void, thisArg?: any): void;
  (event: "sceneContinueUserActivity", callback: (args: SceneContinueUserActivityEventData) => void, thisArg?: any): void;
  (event: "scenePerformActionForShortcutItem", callback: (args: ScenePerformActionForShortcutItemEventData) => void, thisArg?: any): void;
};

Defined in: application/application-common.ts

Call Signature

ts
(
   eventNames: string, 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
eventNamesstring
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "cssChanged", 
   callback: (args: CssChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when application css is changed.

Parameters
ParameterType
event"cssChanged"
callback(args: CssChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "livesync", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

Event raised then livesync operation is performed.

Parameters
ParameterType
event"livesync"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "launch", 
   callback: (args: LaunchEventData) => void, 
   thisArg?: any): void;

This event is raised on application launchEvent.

Parameters
ParameterType
event"launch"
callback(args: LaunchEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "ready", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised once the JS context is initialized.

Parameters
ParameterType
event"ready"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "displayed", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

Experimental

This event is raised after the application has performed most of its startup actions. Its intent is to be suitable for measuring app startup times.

Parameters
ParameterType
event"displayed"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "suspend", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is suspended.

Parameters
ParameterType
event"suspend"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "resume", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is resumed after it has been suspended.

Parameters
ParameterType
event"resume"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "exit", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is about to exit.

On Android it is raised when the last window closes; the process may stay alive. On iOS it is raised when the process itself terminates.

Parameters
ParameterType
event"exit"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "lowMemory", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when there is low memory on the target device.

Parameters
ParameterType
event"lowMemory"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "uncaughtError", 
   callback: (args: UnhandledErrorEventData) => void, 
   thisArg?: any): void;

This event is raised when an uncaught error occurs while the application is running.

Parameters
ParameterType
event"uncaughtError"
callback(args: UnhandledErrorEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "discardedError", 
   callback: (args: DiscardedErrorEventData) => void, 
   thisArg?: any): void;

This event is raised when an discarded error occurs while the application is running.

Parameters
ParameterType
event"discardedError"
callback(args: DiscardedErrorEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "orientationChanged", 
   callback: (args: OrientationChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the orientation of the application changes.

Parameters
ParameterType
event"orientationChanged"
callback(args: OrientationChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "systemAppearanceChanged", 
   callback: (args: SystemAppearanceChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the operating system appearance changes between light and dark theme (for Android); between light and dark mode (for iOS) and vice versa.

Parameters
ParameterType
event"systemAppearanceChanged"
callback(args: SystemAppearanceChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "layoutDirectionChanged", 
   callback: (args: LayoutDirectionChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the operating system layout direction changes between ltr and rtl.

Parameters
ParameterType
event"layoutDirectionChanged"
callback(args: LayoutDirectionChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "fontScaleChanged", 
   callback: (args: FontScaleChangedEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"fontScaleChanged"
callback(args: FontScaleChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "windowOpen", 
   callback: (args: WindowOpenEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"windowOpen"
callback(args: WindowOpenEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "windowClose", 
   callback: (args: WindowCloseEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"windowClose"
callback(args: WindowCloseEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "primaryWindowChanged", 
   callback: (args: PrimaryWindowChangedEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"primaryWindowChanged"
callback(args: PrimaryWindowChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "sceneOpenURLContexts", 
   callback: (args: SceneOpenURLContextsEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"sceneOpenURLContexts"
callback(args: SceneOpenURLContextsEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "sceneContinueUserActivity", 
   callback: (args: SceneContinueUserActivityEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"sceneContinueUserActivity"
callback(args: SceneContinueUserActivityEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "scenePerformActionForShortcutItem", 
   callback: (args: ScenePerformActionForShortcutItemEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"scenePerformActionForShortcutItem"
callback(args: ScenePerformActionForShortcutItemEventData) => void
thisArg?any
Returns

void

Deprecated

Use Application.android.on() instead.


once

ts
static once: {
  (eventNames: string, callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "cssChanged", callback: (args: CssChangedEventData) => void, thisArg?: any): void;
  (event: "livesync", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "launch", callback: (args: LaunchEventData) => void, thisArg?: any): void;
  (event: "ready", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "displayed", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "suspend", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "resume", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "exit", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "lowMemory", callback: (args: ApplicationEventData) => void, thisArg?: any): void;
  (event: "uncaughtError", callback: (args: UnhandledErrorEventData) => void, thisArg?: any): void;
  (event: "discardedError", callback: (args: DiscardedErrorEventData) => void, thisArg?: any): void;
  (event: "orientationChanged", callback: (args: OrientationChangedEventData) => void, thisArg?: any): void;
  (event: "systemAppearanceChanged", callback: (args: SystemAppearanceChangedEventData) => void, thisArg?: any): void;
  (event: "layoutDirectionChanged", callback: (args: LayoutDirectionChangedEventData) => void, thisArg?: any): void;
  (event: "fontScaleChanged", callback: (args: FontScaleChangedEventData) => void, thisArg?: any): void;
  (event: "windowOpen", callback: (args: WindowOpenEventData) => void, thisArg?: any): void;
  (event: "windowClose", callback: (args: WindowCloseEventData) => void, thisArg?: any): void;
  (event: "primaryWindowChanged", callback: (args: PrimaryWindowChangedEventData) => void, thisArg?: any): void;
  (event: "sceneOpenURLContexts", callback: (args: SceneOpenURLContextsEventData) => void, thisArg?: any): void;
  (event: "sceneContinueUserActivity", callback: (args: SceneContinueUserActivityEventData) => void, thisArg?: any): void;
  (event: "scenePerformActionForShortcutItem", callback: (args: ScenePerformActionForShortcutItemEventData) => void, thisArg?: any): void;
};

Defined in: application/application-common.ts

Call Signature

ts
(
   eventNames: string, 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
eventNamesstring
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "cssChanged", 
   callback: (args: CssChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when application css is changed.

Parameters
ParameterType
event"cssChanged"
callback(args: CssChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "livesync", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

Event raised then livesync operation is performed.

Parameters
ParameterType
event"livesync"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "launch", 
   callback: (args: LaunchEventData) => void, 
   thisArg?: any): void;

This event is raised on application launchEvent.

Parameters
ParameterType
event"launch"
callback(args: LaunchEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "ready", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised once the JS context is initialized.

Parameters
ParameterType
event"ready"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "displayed", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

Experimental

This event is raised after the application has performed most of its startup actions. Its intent is to be suitable for measuring app startup times.

Parameters
ParameterType
event"displayed"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "suspend", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is suspended.

Parameters
ParameterType
event"suspend"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "resume", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is resumed after it has been suspended.

Parameters
ParameterType
event"resume"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "exit", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when the Application is about to exit.

On Android it is raised when the last window closes; the process may stay alive. On iOS it is raised when the process itself terminates.

Parameters
ParameterType
event"exit"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "lowMemory", 
   callback: (args: ApplicationEventData) => void, 
   thisArg?: any): void;

This event is raised when there is low memory on the target device.

Parameters
ParameterType
event"lowMemory"
callback(args: ApplicationEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "uncaughtError", 
   callback: (args: UnhandledErrorEventData) => void, 
   thisArg?: any): void;

This event is raised when an uncaught error occurs while the application is running.

Parameters
ParameterType
event"uncaughtError"
callback(args: UnhandledErrorEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "discardedError", 
   callback: (args: DiscardedErrorEventData) => void, 
   thisArg?: any): void;

This event is raised when an discarded error occurs while the application is running.

Parameters
ParameterType
event"discardedError"
callback(args: DiscardedErrorEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "orientationChanged", 
   callback: (args: OrientationChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the orientation of the application changes.

Parameters
ParameterType
event"orientationChanged"
callback(args: OrientationChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "systemAppearanceChanged", 
   callback: (args: SystemAppearanceChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the operating system appearance changes between light and dark theme (for Android); between light and dark mode (for iOS) and vice versa.

Parameters
ParameterType
event"systemAppearanceChanged"
callback(args: SystemAppearanceChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "layoutDirectionChanged", 
   callback: (args: LayoutDirectionChangedEventData) => void, 
   thisArg?: any): void;

This event is raised when the operating system layout direction changes between ltr and rtl.

Parameters
ParameterType
event"layoutDirectionChanged"
callback(args: LayoutDirectionChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "fontScaleChanged", 
   callback: (args: FontScaleChangedEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"fontScaleChanged"
callback(args: FontScaleChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "windowOpen", 
   callback: (args: WindowOpenEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"windowOpen"
callback(args: WindowOpenEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "windowClose", 
   callback: (args: WindowCloseEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"windowClose"
callback(args: WindowCloseEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "primaryWindowChanged", 
   callback: (args: PrimaryWindowChangedEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"primaryWindowChanged"
callback(args: PrimaryWindowChangedEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "sceneOpenURLContexts", 
   callback: (args: SceneOpenURLContextsEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"sceneOpenURLContexts"
callback(args: SceneOpenURLContextsEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "sceneContinueUserActivity", 
   callback: (args: SceneContinueUserActivityEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"sceneContinueUserActivity"
callback(args: SceneContinueUserActivityEventData) => void
thisArg?any
Returns

void

Call Signature

ts
(
   event: "scenePerformActionForShortcutItem", 
   callback: (args: ScenePerformActionForShortcutItemEventData) => void, 
   thisArg?: any): void;
Parameters
ParameterType
event"scenePerformActionForShortcutItem"
callback(args: ScenePerformActionForShortcutItemEventData) => void
thisArg?any
Returns

void

Deprecated

Use Application.android.once() instead.

Accessors

activeWindow

Get Signature

ts
get activeWindow(): NativeWindow;

Defined in: application/application-common.ts

Get the NativeWindow the user is currently interacting with - the one that activated most recently and is still attached. Falls back to the primary window while no window holds activation, which is the case before the first window activates and on a platform that never raises activate.

Returns

NativeWindow


android

Get Signature

ts
get android(): AndroidApplication;

Defined in: application/application-common.ts

Returns

AndroidApplication


AndroidApplication

Get Signature

ts
get AndroidApplication(): AndroidApplication;

Defined in: application/application-common.ts

Returns

AndroidApplication


autoSystemAppearanceChanged

Get Signature

ts
get autoSystemAppearanceChanged(): boolean;

Defined in: application/application-common.ts

Boolean to enable/disable systemAppearanceChanged

Returns

boolean

Set Signature

ts
set autoSystemAppearanceChanged(value: boolean): void;

Defined in: application/application-common.ts

Parameters
ParameterType
valueboolean
Returns

void


inBackground

Get Signature

ts
get inBackground(): boolean;

Defined in: application/application-common.ts

Returns

boolean


ios

Get Signature

ts
get ios(): iOSApplication;

Defined in: application/application-common.ts

Returns

iOSApplication


iOSApplication

Get Signature

ts
get iOSApplication(): iOSApplication;

Defined in: application/application-common.ts

Returns

iOSApplication


primaryWindow

Get Signature

ts
get primaryWindow(): NativeWindow;

Defined in: application/application-common.ts

Get the primary NativeWindow.

Returns

NativeWindow


suspended

Get Signature

ts
get suspended(): boolean;

Defined in: application/application-common.ts

Returns

boolean

Methods

_onPrimaryWindowPromoted()

ts
protected _onPrimaryWindowPromoted(nativeWindow: NativeWindow): void;

Defined in: application/application-common.ts

Hook for platform-specific bookkeeping right after a window takes over the primary role, before primaryWindowChanged is raised.

Parameters

ParameterType
nativeWindowNativeWindow

Returns

void


_onWindowRegistered()

ts
protected _onWindowRegistered(nativeWindow: NativeWindow): void;

Defined in: application/application-common.ts

Hook for platform-specific bookkeeping right after a window joins the registry, before windowOpen is raised.

Parameters

ParameterType
nativeWindowNativeWindow

Returns

void


addCss()

ts
addCss(cssText: string, attributeScoped?: boolean): void;

Defined in: application/application-common.ts

Parameters

ParameterType
cssTextstring
attributeScoped?boolean

Returns

void


applyCssClass()

ts
applyCssClass(
   rootView: View, 
   cssClasses: string[], 
   newCssClass: string, 
   skipCssUpdate?: boolean): void;

Defined in: application/application-common.ts

Applies the the newCssClass to the rootView and removes all other css classes from cssClasses previously applied to the rootView.

Parameters

ParameterTypeDescription
rootViewView-
cssClassesstring[]-
newCssClassstring-
skipCssUpdate?boolean-

Returns

void


createRootView()

ts
createRootView(
   view?: View, 
   fireLaunchEvent?: boolean, 
   additionalLanchEventData?: any): View;

Defined in: application/application-common.ts

Parameters

ParameterType
view?View
fireLaunchEvent?boolean
additionalLanchEventData?any

Returns

View


getCssFileName()

ts
getCssFileName(): string;

Defined in: application/application-common.ts

Gets css file name for the application.

Returns

string


getLayoutDirection()

ts
protected getLayoutDirection(): LayoutDirectionType;

Defined in: application/application-common.ts

Returns

LayoutDirectionType


getMainEntry()

ts
getMainEntry(): any;

Defined in: application/application-common.ts

Returns

any

The main entry of the application


getNativeApplication()

ts
getNativeApplication(): any;

Defined in: application/application-common.ts

Returns

any


getOrientation()

ts
protected getOrientation(): "portrait" | "landscape" | "unknown";

Defined in: application/application-common.ts

Returns

"portrait" | "landscape" | "unknown"


getResources()

ts
getResources(): any;

Defined in: application/application-common.ts

Get application level static resources.

Returns

any


getRootView()

ts
getRootView(): View;

Defined in: application/application-common.ts

Returns

View


getSystemAppearance()

ts
protected getSystemAppearance(): "dark" | "light";

Defined in: application/application-common.ts

Returns

"dark" | "light"


getWindowById()

ts
getWindowById(id: string): NativeWindow;

Defined in: application/application-common.ts

Get a registered NativeWindow by its id.

Parameters

ParameterType
idstring

Returns

NativeWindow


getWindowContentResolver()

ts
getWindowContentResolver(): WindowContentResolver;

Defined in: application/application-common.ts

Returns

WindowContentResolver

The callback currently supplying window content, if any.


getWindows()

Call Signature

ts
getWindows(role: "all"): WindowBase[];

Defined in: application/application-common.ts

Get the active windows, filtered by role.

Defaults to the view-carrying app windows (application and embedded). Pass 'all' to include every registered surface, including ones that carry no view tree.

Parameters
ParameterType
role"all"
Returns

WindowBase[]

Call Signature

ts
getWindows(role?: 
  | WindowRole
  | WindowRole[]): NativeWindow[];

Defined in: application/application-common.ts

Get the active windows, filtered by role.

Defaults to the view-carrying app windows (application and embedded). Pass 'all' to include every registered surface, including ones that carry no view tree.

Parameters
ParameterType
role?| WindowRole | WindowRole[]
Returns

NativeWindow[]

Call Signature

ts
getWindows(role?: 
  | "all"
  | WindowRole
  | WindowRole[]): WindowBase[];

Defined in: application/application-common.ts

Get the active windows, filtered by role.

Defaults to the view-carrying app windows (application and embedded). Pass 'all' to include every registered surface, including ones that carry no view tree.

Parameters
ParameterType
role?| "all" | WindowRole | WindowRole[]
Returns

WindowBase[]


hasLaunched()

ts
hasLaunched(): boolean;

Defined in: application/application-common.ts

Returns

boolean


initRootView()

ts
initRootView(rootView: View, window?: NativeWindow): void;

Defined in: application/application-common.ts

Parameters

ParameterTypeDescription
rootViewView-
window?NativeWindowthe window the root view belongs to. Supplies the window-scoped CSS classes; without it they come from the primary window.

Returns

void


layoutDirection()

ts
layoutDirection(): LayoutDirectionType;

Defined in: application/application-common.ts

Returns

LayoutDirectionType

Deprecated

Use Application.primaryWindow?.layoutDirection() - or the NativeWindow of the relevant view - instead. Continues to reflect the primary window.


layoutDirectionChanged()

ts
layoutDirectionChanged(rootView: View, newLayoutDirection: LayoutDirectionType): void;

Defined in: application/application-common.ts

Updates root view classes including those of modals

Parameters

ParameterTypeDescription
rootViewViewthe root view
newLayoutDirectionLayoutDirectionTypethe new layout direction change

Returns

void


loadAppCss()

ts
loadAppCss(): void;

Defined in: application/application-common.ts

Loads immediately the app.css. By default the app.css file is loaded shortly after "loaded". For the Android snapshot the CSS can be parsed during the snapshot generation, as the CSS does not depend on runtime APIs, and loadAppCss will be called explicitly.

Returns

void


notifyLaunch()

ts
protected notifyLaunch(additionalLanchEventData?: any): View;

Defined in: application/application-common.ts

Parameters

ParameterType
additionalLanchEventData?any

Returns

View


openWindow()

ts
openWindow(options?: WindowOpenOptions): void;

Defined in: application/application-common.ts

Opens a new window.

Parameters

ParameterTypeDescription
options?WindowOpenOptionsOptions for the new window, including data to hand to it.

Returns

void


orientation()

ts
orientation(): "portrait" | "landscape" | "unknown";

Defined in: application/application-common.ts

Returns

"portrait" | "landscape" | "unknown"

Deprecated

Use Application.primaryWindow?.orientation() - or the NativeWindow of the relevant view - instead. Continues to reflect the primary window.


orientationChanged()

ts
orientationChanged(rootView: View, newOrientation: "portrait" | "landscape" | "unknown"): void;

Defined in: application/application-common.ts

Parameters

ParameterType
rootViewView
newOrientation"portrait" | "landscape" | "unknown"

Returns

void


resetRootView()

ts
resetRootView(entry?: string | NavigationEntry): void;

Defined in: application/application-common.ts

Parameters

ParameterType
entry?string | NavigationEntry

Returns

void


run()

ts
run(entry?: string | NavigationEntry): void;

Defined in: application/application-common.ts

Parameters

ParameterType
entry?string | NavigationEntry

Returns

void


setAutoSystemAppearanceChanged()

ts
setAutoSystemAppearanceChanged(value: boolean): void;

Defined in: application/application-common.ts

enable/disable systemAppearanceChanged

Parameters

ParameterType
valueboolean

Returns

void


setCssFileName()

ts
setCssFileName(cssFileName: string): void;

Defined in: application/application-common.ts

Sets css file name for the application.

Parameters

ParameterType
cssFileNamestring

Returns

void


setInBackground()

ts
setInBackground(value: boolean, additonalData?: any): void;

Defined in: application/application-common.ts

Parameters

ParameterType
valueboolean
additonalData?any

Returns

void


setLayoutDirection()

ts
protected setLayoutDirection(value: LayoutDirectionType): void;

Defined in: application/application-common.ts

Parameters

ParameterType
valueLayoutDirectionType

Returns

void


setMaxRefreshRate()

ts
setMaxRefreshRate(options?: {
  max?: number;
  min?: number;
  preferred?: number;
}): void;

Defined in: application/application-common.ts

iOS Only Dynamically change the preferred frame rate For devices (iOS 15+) which support min/max/preferred frame rate you can specify ranges For devices (iOS < 15), you can specify the max frame rate see: https://developer.apple.com/documentation/quartzcore/optimizing_promotion_refresh_rates_for_iphone_13_pro_and_ipad_pro To use, ensure your Info.plist has:

xml
  <key>CADisableMinimumFrameDurationOnPhone</key>
  <true/>

Parameters

ParameterTypeDescription
options?{ max?: number; min?: number; preferred?: number; }{ min?: number; max?: number; preferred?: number }
options.max?number-
options.min?number-
options.preferred?number-

Returns

void


setOrientation()

ts
protected setOrientation(value: "portrait" | "landscape" | "unknown"): void;

Defined in: application/application-common.ts

Parameters

ParameterType
value"portrait" | "landscape" | "unknown"

Returns

void


setResources()

ts
setResources(res: any): void;

Defined in: application/application-common.ts

Set application level static resources.

Parameters

ParameterType
resany

Returns

void


setSuspended()

ts
setSuspended(value: boolean, additonalData?: any): void;

Defined in: application/application-common.ts

Parameters

ParameterType
valueboolean
additonalData?any

Returns

void


setSystemAppearance()

ts
protected setSystemAppearance(value: "dark" | "light"): void;

Defined in: application/application-common.ts

Parameters

ParameterType
value"dark" | "light"

Returns

void


setWindowContentResolver()

ts
setWindowContentResolver(resolver: WindowContentResolver): void;

Defined in: application/application-common.ts

Sets the callback that supplies the UI for windows that need content. Pass null to remove a previously set resolver.

Parameters

ParameterType
resolverWindowContentResolver

Returns

void


systemAppearance()

ts
systemAppearance(): "dark" | "light";

Defined in: application/application-common.ts

Returns

"dark" | "light"

Deprecated

Use Application.primaryWindow?.systemAppearance() - or the NativeWindow of the relevant view - instead. Continues to reflect the primary window.


systemAppearanceChanged()

ts
systemAppearanceChanged(rootView: View, newSystemAppearance: "dark" | "light"): void;

Defined in: application/application-common.ts

Updates root view classes including those of modals

Parameters

ParameterTypeDescription
rootViewViewthe root view
newSystemAppearance"dark" | "light"the new appearance change

Returns

void

Previous
Animation