Classdesc

An object representing an application. Allows the developer to create, execute, show/close an application as well as listen to application events.

Hideconstructor

Hierarchy

Constructors

Properties

_manifestUrl?: string
addListener: (<EventType>(eventType: EventType, listener: EventHandler<OpenFin.ApplicationEvents.ApplicationEvent, EventType>, options?: SubscriptionOptions) => Promise<OpenFin.Application>) = ...

Type declaration

    • <EventType>(eventType: EventType, listener: EventHandler<OpenFin.ApplicationEvents.ApplicationEvent, EventType>, options?: SubscriptionOptions): Promise<OpenFin.Application>
    • Type Parameters

      • EventType extends "crashed" | "started" | "closed" | "initialized" | "view-attached" | "window-alert-requested" | "window-created" | "window-end-load" | "window-not-responding" | "window-responding" | "window-start-load" | "connected" | "manifest-changed" | "not-responding" | "responding" | "run-requested" | "tray-icon-clicked" | "file-download-location-changed" | "view-blurred" | "view-certificate-selection-shown" | "view-crashed" | "view-did-change-theme-color" | "view-focused" | "view-navigation-rejected" | "view-url-changed" | "view-did-fail-load" | "view-did-finish-load" | "view-page-favicon-updated" | "view-page-title-updated" | "view-resource-load-failed" | "view-response-received" | "view-child-content-blocked" | "view-child-content-opened-in-browser" | "view-child-view-created" | "view-file-download-started" | "view-file-download-progress" | "view-file-download-completed" | "view-created" | "view-destroyed" | "view-hidden" | "view-hotkey" | "view-shown" | "view-target-changed" | "window-blurred" | "window-certificate-selection-shown" | "window-crashed" | "window-did-change-theme-color" | "window-focused" | "window-navigation-rejected" | "window-url-changed" | "window-did-fail-load" | "window-did-finish-load" | "window-page-favicon-updated" | "window-page-title-updated" | "window-resource-load-failed" | "window-response-received" | "window-child-content-blocked" | "window-child-content-opened-in-browser" | "window-child-view-created" | "window-file-download-started" | "window-file-download-progress" | "window-file-download-completed" | "window-view-attached" | "window-view-detached" | "window-auth-requested" | "window-begin-user-bounds-changing" | "window-bounds-changed" | "window-bounds-changing" | "window-closed" | "window-closing" | "window-disabled-movement-bounds-changed" | "window-disabled-movement-bounds-changing" | "window-embedded" | "window-end-user-bounds-changing" | "window-external-process-exited" | "window-external-process-started" | "window-hidden" | "window-hotkey" | "window-initialized" | "window-layout-initialized" | "window-layout-ready" | "window-maximized" | "window-minimized" | "window-options-changed" | "window-performance-report" | "window-preload-script-state-changed" | "window-preload-script-state-changing" | "window-reloaded" | "window-restored" | "window-show-requested" | "window-shown" | "window-user-movement-disabled" | "window-user-movement-enabled" | "window-will-move" | "window-will-redirect" | "window-will-resize"

      Parameters

      Returns Promise<OpenFin.Application>

wire: Transport<EntityType>

Accessors

Methods

  • Parameters

    • force: boolean = false

    Returns Promise<void>

  • Type Parameters

    • EventType extends string

    Parameters

    • eventType: EventType
    • payload: Extract<EmitterEvent, {
          type: EventType;
      }>
    • Rest ...args: any[]

    Returns boolean

  • Returns (string | symbol)[]

  • Retrieves an array of wrapped fin.Windows for each of the application’s child windows.

    Returns

    Tutorial

    Application.getChildWindows

    Returns Promise<Window[]>

  • Gets file auto download location. It's only allowed in the same application. If file auto download location is not set, it will return the default location. Note: This method is restricted by default and must be enabled via API security settings.

    Returns

    Throws

    if getting file auto download location on different applications.

    Tutorial

    Application.getFileDownloadLocation

    Returns Promise<string>

  • Retrieves information about the application.

    Returns

    Tutorial

    Application.getInfo

    Returns Promise<ApplicationInfo>

  • Retrieves the JSON manifest that was used to create the application. Invokes the error callback if the application was not created from a manifest.

    Returns

    Tutorial

    Application.getManifest

    Returns Promise<Manifest>

  • Retrieves UUID of the application that launches this application. Invokes the error callback if the application was created from a manifest.

    Returns

    Tutorial

    Application.getParentUuid

    Returns Promise<string>

  • Experimental

    Retrieves all process information for entities (windows and views) associated with an application.

    Returns

    Tutorial

    Application.getProcessInfo

    Returns Promise<AppProcessInfo>

  • Retrieves current application's shortcut configuration.

    Returns

    Tutorial

    Application.getShortcuts

    Returns Promise<ShortCutConfig>

  • Summary

    Retrieves information about the system tray. If the system tray is not set, it will throw an error message.

    Desc

    The only information currently returned is the position and dimensions.

    Returns

    Tutorial

    Application.getTrayIconInfo

    Returns Promise<TrayInfo>

  • Experimental

    Retrieves current application's views.

    Returns

    Tutorial

    Application.getViews

    Returns Promise<OpenFin.View[]>

  • Returns an instance of the main Window of the application

    Returns

    Tutorial

    Application.getWindow

    Returns Promise<Window>

  • Returns the current zoom level of the application.

    Returns

    Tutorial

    Application.getZoomLevel

    Returns Promise<number>

  • Summary

    Checks if the application has an associated tray icon.

    Returns

    Tutorial

    Application.hasTrayIcon

    Returns Promise<boolean>

  • PORTED

    JumpListItem interface

    Property

    One of the following: "task" or "separator". Defaults to task.

    Property

    The text to be displayed for the JumpList Item. Should only be set if type is "task".

    Property

    Description of the task (displayed in a tooltip). Should only be set if type is "task".

    Property

    Deep link to a manifest, i.e: fins://path.to/manifest.json?$$param1=value1. See deep-linking for more information.

    Property

    The absolute path to an icon to be displayed for the item, which can be an arbitrary resource file that contains an icon (e.g. .ico, .exe, .dll).

    Property

    The index of the icon in the resource file. If a resource file contains multiple icons this value can be used to specify the zero-based index of the icon that should be displayed for this task. If a resource file contains only one icon, this property should be set to zero.

    Returns Promise<boolean>

  • Parameters

    • type: string | symbol

    Returns number

  • Parameters

    • type: string | symbol

    Returns Function[]

  • Type Parameters

    • EventType extends "crashed" | "started" | "closed" | "initialized" | "view-attached" | "window-alert-requested" | "window-created" | "window-end-load" | "window-not-responding" | "window-responding" | "window-start-load" | "connected" | "manifest-changed" | "not-responding" | "responding" | "run-requested" | "tray-icon-clicked" | "file-download-location-changed" | "view-blurred" | "view-certificate-selection-shown" | "view-crashed" | "view-did-change-theme-color" | "view-focused" | "view-navigation-rejected" | "view-url-changed" | "view-did-fail-load" | "view-did-finish-load" | "view-page-favicon-updated" | "view-page-title-updated" | "view-resource-load-failed" | "view-response-received" | "view-child-content-blocked" | "view-child-content-opened-in-browser" | "view-child-view-created" | "view-file-download-started" | "view-file-download-progress" | "view-file-download-completed" | "view-created" | "view-destroyed" | "view-hidden" | "view-hotkey" | "view-shown" | "view-target-changed" | "window-blurred" | "window-certificate-selection-shown" | "window-crashed" | "window-did-change-theme-color" | "window-focused" | "window-navigation-rejected" | "window-url-changed" | "window-did-fail-load" | "window-did-finish-load" | "window-page-favicon-updated" | "window-page-title-updated" | "window-resource-load-failed" | "window-response-received" | "window-child-content-blocked" | "window-child-content-opened-in-browser" | "window-child-view-created" | "window-file-download-started" | "window-file-download-progress" | "window-file-download-completed" | "window-view-attached" | "window-view-detached" | "window-auth-requested" | "window-begin-user-bounds-changing" | "window-bounds-changed" | "window-bounds-changing" | "window-closed" | "window-closing" | "window-disabled-movement-bounds-changed" | "window-disabled-movement-bounds-changing" | "window-embedded" | "window-end-user-bounds-changing" | "window-external-process-exited" | "window-external-process-started" | "window-hidden" | "window-hotkey" | "window-initialized" | "window-layout-initialized" | "window-layout-ready" | "window-maximized" | "window-minimized" | "window-options-changed" | "window-performance-report" | "window-preload-script-state-changed" | "window-preload-script-state-changing" | "window-reloaded" | "window-restored" | "window-show-requested" | "window-shown" | "window-user-movement-disabled" | "window-user-movement-enabled" | "window-will-move" | "window-will-redirect" | "window-will-resize"

    Parameters

    Returns Promise<OpenFin.Application>

  • Type Parameters

    • EventType extends "crashed" | "started" | "closed" | "initialized" | "view-attached" | "window-alert-requested" | "window-created" | "window-end-load" | "window-not-responding" | "window-responding" | "window-start-load" | "connected" | "manifest-changed" | "not-responding" | "responding" | "run-requested" | "tray-icon-clicked" | "file-download-location-changed" | "view-blurred" | "view-certificate-selection-shown" | "view-crashed" | "view-did-change-theme-color" | "view-focused" | "view-navigation-rejected" | "view-url-changed" | "view-did-fail-load" | "view-did-finish-load" | "view-page-favicon-updated" | "view-page-title-updated" | "view-resource-load-failed" | "view-response-received" | "view-child-content-blocked" | "view-child-content-opened-in-browser" | "view-child-view-created" | "view-file-download-started" | "view-file-download-progress" | "view-file-download-completed" | "view-created" | "view-destroyed" | "view-hidden" | "view-hotkey" | "view-shown" | "view-target-changed" | "window-blurred" | "window-certificate-selection-shown" | "window-crashed" | "window-did-change-theme-color" | "window-focused" | "window-navigation-rejected" | "window-url-changed" | "window-did-fail-load" | "window-did-finish-load" | "window-page-favicon-updated" | "window-page-title-updated" | "window-resource-load-failed" | "window-response-received" | "window-child-content-blocked" | "window-child-content-opened-in-browser" | "window-child-view-created" | "window-file-download-started" | "window-file-download-progress" | "window-file-download-completed" | "window-view-attached" | "window-view-detached" | "window-auth-requested" | "window-begin-user-bounds-changing" | "window-bounds-changed" | "window-bounds-changing" | "window-closed" | "window-closing" | "window-disabled-movement-bounds-changed" | "window-disabled-movement-bounds-changing" | "window-embedded" | "window-end-user-bounds-changing" | "window-external-process-exited" | "window-external-process-started" | "window-hidden" | "window-hotkey" | "window-initialized" | "window-layout-initialized" | "window-layout-ready" | "window-maximized" | "window-minimized" | "window-options-changed" | "window-performance-report" | "window-preload-script-state-changed" | "window-preload-script-state-changing" | "window-reloaded" | "window-restored" | "window-show-requested" | "window-shown" | "window-user-movement-disabled" | "window-user-movement-enabled" | "window-will-move" | "window-will-redirect" | "window-will-resize"

    Parameters

    Returns Promise<OpenFin.Application>

  • Type Parameters

    • EventType extends "crashed" | "started" | "closed" | "initialized" | "view-attached" | "window-alert-requested" | "window-created" | "window-end-load" | "window-not-responding" | "window-responding" | "window-start-load" | "connected" | "manifest-changed" | "not-responding" | "responding" | "run-requested" | "tray-icon-clicked" | "file-download-location-changed" | "view-blurred" | "view-certificate-selection-shown" | "view-crashed" | "view-did-change-theme-color" | "view-focused" | "view-navigation-rejected" | "view-url-changed" | "view-did-fail-load" | "view-did-finish-load" | "view-page-favicon-updated" | "view-page-title-updated" | "view-resource-load-failed" | "view-response-received" | "view-child-content-blocked" | "view-child-content-opened-in-browser" | "view-child-view-created" | "view-file-download-started" | "view-file-download-progress" | "view-file-download-completed" | "view-created" | "view-destroyed" | "view-hidden" | "view-hotkey" | "view-shown" | "view-target-changed" | "window-blurred" | "window-certificate-selection-shown" | "window-crashed" | "window-did-change-theme-color" | "window-focused" | "window-navigation-rejected" | "window-url-changed" | "window-did-fail-load" | "window-did-finish-load" | "window-page-favicon-updated" | "window-page-title-updated" | "window-resource-load-failed" | "window-response-received" | "window-child-content-blocked" | "window-child-content-opened-in-browser" | "window-child-view-created" | "window-file-download-started" | "window-file-download-progress" | "window-file-download-completed" | "window-view-attached" | "window-view-detached" | "window-auth-requested" | "window-begin-user-bounds-changing" | "window-bounds-changed" | "window-bounds-changing" | "window-closed" | "window-closing" | "window-disabled-movement-bounds-changed" | "window-disabled-movement-bounds-changing" | "window-embedded" | "window-end-user-bounds-changing" | "window-external-process-exited" | "window-external-process-started" | "window-hidden" | "window-hotkey" | "window-initialized" | "window-layout-initialized" | "window-layout-ready" | "window-maximized" | "window-minimized" | "window-options-changed" | "window-performance-report" | "window-preload-script-state-changed" | "window-preload-script-state-changing" | "window-reloaded" | "window-restored" | "window-show-requested" | "window-shown" | "window-user-movement-disabled" | "window-user-movement-enabled" | "window-will-move" | "window-will-redirect" | "window-will-resize"

    Parameters

    Returns Promise<OpenFin.Application>

  • Type Parameters

    • EventType extends "crashed" | "started" | "closed" | "initialized" | "view-attached" | "window-alert-requested" | "window-created" | "window-end-load" | "window-not-responding" | "window-responding" | "window-start-load" | "connected" | "manifest-changed" | "not-responding" | "responding" | "run-requested" | "tray-icon-clicked" | "file-download-location-changed" | "view-blurred" | "view-certificate-selection-shown" | "view-crashed" | "view-did-change-theme-color" | "view-focused" | "view-navigation-rejected" | "view-url-changed" | "view-did-fail-load" | "view-did-finish-load" | "view-page-favicon-updated" | "view-page-title-updated" | "view-resource-load-failed" | "view-response-received" | "view-child-content-blocked" | "view-child-content-opened-in-browser" | "view-child-view-created" | "view-file-download-started" | "view-file-download-progress" | "view-file-download-completed" | "view-created" | "view-destroyed" | "view-hidden" | "view-hotkey" | "view-shown" | "view-target-changed" | "window-blurred" | "window-certificate-selection-shown" | "window-crashed" | "window-did-change-theme-color" | "window-focused" | "window-navigation-rejected" | "window-url-changed" | "window-did-fail-load" | "window-did-finish-load" | "window-page-favicon-updated" | "window-page-title-updated" | "window-resource-load-failed" | "window-response-received" | "window-child-content-blocked" | "window-child-content-opened-in-browser" | "window-child-view-created" | "window-file-download-started" | "window-file-download-progress" | "window-file-download-completed" | "window-view-attached" | "window-view-detached" | "window-auth-requested" | "window-begin-user-bounds-changing" | "window-bounds-changed" | "window-bounds-changing" | "window-closed" | "window-closing" | "window-disabled-movement-bounds-changed" | "window-disabled-movement-bounds-changing" | "window-embedded" | "window-end-user-bounds-changing" | "window-external-process-exited" | "window-external-process-started" | "window-hidden" | "window-hotkey" | "window-initialized" | "window-layout-initialized" | "window-layout-ready" | "window-maximized" | "window-minimized" | "window-options-changed" | "window-performance-report" | "window-preload-script-state-changed" | "window-preload-script-state-changing" | "window-reloaded" | "window-restored" | "window-show-requested" | "window-shown" | "window-user-movement-disabled" | "window-user-movement-enabled" | "window-will-move" | "window-will-redirect" | "window-will-resize"

    Parameters

    Returns Promise<OpenFin.Application>

  • Closes the application and any child windows created by the application. Cleans the application from state so it is no longer found in getAllApplications.

    Returns

    Tutorial

    Application.quit

    Parameters

    • Optional force: boolean = false

    Returns Promise<void>

  • Manually registers a user with the licensing service. The only data sent by this call is userName and appName.

    Returns

    Tutorial

    Application.registerUser

    Parameters

    • userName: string

      username to be passed to the RVM.

    • appName: string

      app name to be passed to the RVM.

    Returns Promise<void>

  • Parameters

    • Optional eventType: "crashed" | "started" | "closed" | "initialized" | "view-attached" | "window-alert-requested" | "window-created" | "window-end-load" | "window-not-responding" | "window-responding" | "window-start-load" | "connected" | "manifest-changed" | "not-responding" | "responding" | "run-requested" | "tray-icon-clicked" | "file-download-location-changed" | "view-blurred" | "view-certificate-selection-shown" | "view-crashed" | "view-did-change-theme-color" | "view-focused" | "view-navigation-rejected" | "view-url-changed" | "view-did-fail-load" | "view-did-finish-load" | "view-page-favicon-updated" | "view-page-title-updated" | "view-resource-load-failed" | "view-response-received" | "view-child-content-blocked" | "view-child-content-opened-in-browser" | "view-child-view-created" | "view-file-download-started" | "view-file-download-progress" | "view-file-download-completed" | "view-created" | "view-destroyed" | "view-hidden" | "view-hotkey" | "view-shown" | "view-target-changed" | "window-blurred" | "window-certificate-selection-shown" | "window-crashed" | "window-did-change-theme-color" | "window-focused" | "window-navigation-rejected" | "window-url-changed" | "window-did-fail-load" | "window-did-finish-load" | "window-page-favicon-updated" | "window-page-title-updated" | "window-resource-load-failed" | "window-response-received" | "window-child-content-blocked" | "window-child-content-opened-in-browser" | "window-child-view-created" | "window-file-download-started" | "window-file-download-progress" | "window-file-download-completed" | "window-view-attached" | "window-view-detached" | "window-auth-requested" | "window-begin-user-bounds-changing" | "window-bounds-changed" | "window-bounds-changing" | "window-closed" | "window-closing" | "window-disabled-movement-bounds-changed" | "window-disabled-movement-bounds-changing" | "window-embedded" | "window-end-user-bounds-changing" | "window-external-process-exited" | "window-external-process-started" | "window-hidden" | "window-hotkey" | "window-initialized" | "window-layout-initialized" | "window-layout-ready" | "window-maximized" | "window-minimized" | "window-options-changed" | "window-performance-report" | "window-preload-script-state-changed" | "window-preload-script-state-changing" | "window-reloaded" | "window-restored" | "window-show-requested" | "window-shown" | "window-user-movement-disabled" | "window-user-movement-enabled" | "window-will-move" | "window-will-redirect" | "window-will-resize"

    Returns Promise<OpenFin.Application>

  • Type Parameters

    • EventType extends "crashed" | "started" | "closed" | "initialized" | "view-attached" | "window-alert-requested" | "window-created" | "window-end-load" | "window-not-responding" | "window-responding" | "window-start-load" | "connected" | "manifest-changed" | "not-responding" | "responding" | "run-requested" | "tray-icon-clicked" | "file-download-location-changed" | "view-blurred" | "view-certificate-selection-shown" | "view-crashed" | "view-did-change-theme-color" | "view-focused" | "view-navigation-rejected" | "view-url-changed" | "view-did-fail-load" | "view-did-finish-load" | "view-page-favicon-updated" | "view-page-title-updated" | "view-resource-load-failed" | "view-response-received" | "view-child-content-blocked" | "view-child-content-opened-in-browser" | "view-child-view-created" | "view-file-download-started" | "view-file-download-progress" | "view-file-download-completed" | "view-created" | "view-destroyed" | "view-hidden" | "view-hotkey" | "view-shown" | "view-target-changed" | "window-blurred" | "window-certificate-selection-shown" | "window-crashed" | "window-did-change-theme-color" | "window-focused" | "window-navigation-rejected" | "window-url-changed" | "window-did-fail-load" | "window-did-finish-load" | "window-page-favicon-updated" | "window-page-title-updated" | "window-resource-load-failed" | "window-response-received" | "window-child-content-blocked" | "window-child-content-opened-in-browser" | "window-child-view-created" | "window-file-download-started" | "window-file-download-progress" | "window-file-download-completed" | "window-view-attached" | "window-view-detached" | "window-auth-requested" | "window-begin-user-bounds-changing" | "window-bounds-changed" | "window-bounds-changing" | "window-closed" | "window-closing" | "window-disabled-movement-bounds-changed" | "window-disabled-movement-bounds-changing" | "window-embedded" | "window-end-user-bounds-changing" | "window-external-process-exited" | "window-external-process-started" | "window-hidden" | "window-hotkey" | "window-initialized" | "window-layout-initialized" | "window-layout-ready" | "window-maximized" | "window-minimized" | "window-options-changed" | "window-performance-report" | "window-preload-script-state-changed" | "window-preload-script-state-changing" | "window-reloaded" | "window-restored" | "window-show-requested" | "window-shown" | "window-user-movement-disabled" | "window-user-movement-enabled" | "window-will-move" | "window-will-redirect" | "window-will-resize"

    Parameters

    Returns Promise<OpenFin.Application>

  • Removes the application’s icon from the tray.

    Returns

    Tutorial

    Application.removeTrayIcon

    Returns Promise<void>

  • Restarts the application.

    Returns

    Tutorial

    Application.restart

    Returns Promise<void>

  • Instructs the RVM to schedule one restart of the application.

    Returns

    Tutorial

    Application.scheduleRestart

    Returns Promise<void>

  • Sends a message to the RVM to upload the application's logs. On success, an object containing logId is returned.

    Returns

    Tutorial

    Application.sendApplicationLog

    Returns Promise<SendApplicationLogResponse>

  • Sets a username to correlate with App Log Management.

    Returns

    Tutorial

    Application.setAppLogUsername

    Parameters

    • username: string

      Username to correlate with App's Log.

    Returns Promise<void>

  • Sets file auto download location. It's only allowed in the same application. Note: This method is restricted by default and must be enabled via API security settings.

    Returns

    Throws

    if setting file auto download location on different applications.

    Tutorial

    Application.setFileDownloadLocation

    Parameters

    • downloadLocation: string

      file auto download location

    Returns Promise<void>

  • Sets or removes a custom JumpList for the application. Only applicable in Windows OS. If categories is null the previously set custom JumpList (if any) will be replaced by the standard JumpList for the app (managed by Windows). Note: If the "name" property is omitted it defaults to "tasks".

    Returns

    Tutorial

    Application.setJumpList

    Parameters

    • jumpListCategories: null | JumpListCategory[]

      An array of JumpList Categories to populate. If null, remove any existing JumpList configuration and set to Windows default.

    Returns Promise<void>

  • Sets the query string in all shortcuts for this app. Requires RVM 5.5+.

    Returns

    Tutorial

    Application.setShortcutQueryParams

    Parameters

    • queryString: string

      The new query string for this app's shortcuts.

    Returns Promise<void>

  • Sets new application's shortcut configuration. Windows only.

    Returns

    Tutorial

    Application.setShortcuts

    Parameters

    Returns Promise<void>

  • Adds a customizable icon in the system tray. To listen for a click on the icon use the tray-icon-clicked event.

    Returns

    Tutorial

    Application.setTrayIcon

    Parameters

    • icon: string

      Image URL or base64 encoded string to be used as the icon

    Returns Promise<void>

  • Sets the zoom level of the application. The original size is 0 and each increment above or below represents zooming 20% larger or smaller to default limits of 300% and 50% of original size, respectively.

    Returns

    Tutorial

    Application.setZoomLevel

    Parameters

    • level: number

      The zoom level

    Returns Promise<void>

  • Closes the application by terminating its process.

    Returns

    Tutorial

    Application.terminate

    Returns Promise<void>

Generated using TypeDoc