Methods
getResult() → {Promise.<IntentResult>}
Returns:
- Type
- Promise.<IntentResult>
Type Definitions
AddClientToContextGroupOptions
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
contextGroupId |
string | Name of the context group. |
addContextHandler(contextHandler, contextTypeopt) → {Promise.<void>}
A SessionContextGroup instance method for adding a handler for context change.
Parameters:
Name | Type | Attributes | Description |
---|---|---|---|
contextHandler |
ContextHandler | The callback to be invoked. Is invoked when (a) the context changes or (b) immediately after getting created if the context is already set. |
|
contextType |
string |
<optional> |
The context type this handler should listen to. If not specified, a global handler for all context types will get created. Only one global handler is allowed per SessionContextGroup. |
Returns:
- Type
- Promise.<void>
AppIdentifier
Identifies an application, or instance of an application, and is used to target FDC3 API calls at specific applications.
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
appId |
string | The unique application identifier located within a specific application directory instance. An example of an appId might be 'app@sub.root'. |
|
instancedId |
string |
<optional> |
An optional instance identifier, indicating that this object represents a specific instance of the application described. The endpointId should be used as the instanceId. The most convenient way to get this would be to use the InteropBroker.getAllClientInfo API. |
AppIntent
An interface that represents the binding of an intent to apps.
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
intent |
Intent | |
apps |
Array.<AppMetadata> |
AppIntent
An interface that represents the binding of an intent to apps, returned as part of intent discovery. For each intent, it references the applications that support that intent.
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
intent |
IntentMetadata | Details of the intent whose relationship to resolving applications is being described |
apps |
Array.<AppMetadata> |
ApplicationOptions
Application creation options.
This is the options object required by Application.start.
The following options are required:
uuid
is required in the app manifest as well as by Application.startname
is optional in the app manifest but required by Application.starturl
is optional in both the app manifest Application.start and but is usually given (defaults to"about:blank"
when omitted).
This jsdoc typedef mirrors the ApplicationOption
TypeScript interface in @types/openfin
.
IMPORTANT NOTE:
This object inherits all the properties of the window creation options object,
which will take priority over those of the same name that may be provided in mainWindowOptions
.
Type:
- object
Properties:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
disableIabSecureLogging |
boolean |
<optional> |
false | When set to |
loadErrorMessage |
string |
<optional> |
"There was an error loading the application." | An error message to display when the application (launched via manifest) fails to load.
A dialog box will be launched with the error message just before the runtime exits.
Load fails such as failed DNS resolutions or aborted connections as well as cancellations, e.g., |
mainWindowOptions |
Window~options |
<optional> |
The options of the main window of the application. For a description of these options, click the link (in the Type column). |
|
maxViewPoolSize |
number |
<optional> |
1000 | Platforms Only. The maximum number of "detached" or "pooled" Views that can exist in the Platform before being closed. If you do not wish for views to be pooled on your platform, set this property to zero. |
preventQuitOnLastWindowClosed |
boolean |
<optional> |
false | Platforms Only. Prevent the Platform Provider from quitting automatically when the last Platform Window is closed. Note: if the Platform Provider is showing, it won't close automatically. If you want a hidden Platform Provider to remain open after the last Platform Window has been closed, set this property to true. |
name |
string |
<optional> |
The name of the application (and the application's main window). If provided, must match |
|
nonPersistent |
boolean |
<optional> |
false | A flag to configure the application as non-persistent. Runtime exits when there are no persistent apps running. |
plugins |
boolean |
<optional> |
false | Enable Flash at the application level. |
spellCheck |
boolean |
<optional> |
false | Enable spell check at the application level. |
url |
string |
<optional> |
"about:blank" | The url to the application (specifically the application's main window). |
enableJumpList |
boolean |
<optional> |
false | Enables the use of the Jumplists API and the 'pin to taskbar' functionality. Only relevant in Windows. |
uuid |
string | The Unique Universal Identifier (UUID) of the application, unique within the set of all other applications running in the OpenFin Runtime. Note that |
||
webSecurity |
boolean |
<optional> |
true | When set to |
AppMetadata
App metadata is provided by the FDC3 App Directory.
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
name |
string | ||
appId |
string |
<optional> |
|
version |
string |
<optional> |
|
title |
string |
<optional> |
|
tooltip |
string |
<optional> |
|
description |
string |
<optional> |
|
icons |
Array.<string> |
<optional> |
|
images |
Array.<string> |
<optional> |
AppMetadata
Extends an AppIdentifier, describing an application or instance of an application, with additional descriptive metadata that is usually provided by an FDC3 App Directory that the desktop agent connects to.
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
appId |
string | The unique application identifier located within a specific application directory instance. An example of an appId might be 'app@sub.root'. |
|
instanceId |
string |
<optional> |
An optional instance identifier, indicating that this object represents a specific instance of the application described. The endpointId should be used as the instanceId. The most convenient way to get this would be to use the InteropBroker.getAllClientInfo API. |
name |
string |
<optional> |
The 'friendly' app name. This field was used with the |
version |
string |
<optional> |
The version of the application. |
instanceMetadata |
Record.<string, any> |
<optional> |
|
title |
string |
<optional> |
A more user-friendly application title that can be used to render UI elements. |
tooltip |
string |
<optional> |
A tooltip for the application that can be used to render UI elements. |
description |
string |
<optional> |
A longer, multi-paragraph description for the application that could include mark-up. |
icons |
Array.<Icon> |
<optional> |
A list of icon URLs for the application that can be used to render UI elements. |
screenshots |
Array.<Image> |
<optional> |
Images representing the app in common usage scenarios that can be used to render UI elements. |
resultType |
string | null |
<optional> |
The type of result returned for any intent specified during resolution. May express a particular context type (e.g. "fdc3.instrument"), channel (e.g. "channel") or a channel that will receive a specified type (e.g. "channel<fdc3.instrument>"). |
Area
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
height |
number | Area's height |
width |
number | Area's width |
x |
number | X coordinate of area's starting point |
y |
number | Y coordinate of area's starting point |
Bounds
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
height |
number | Get the application height bound |
width |
number | Get the application width bound |
top |
number | Get the application top bound |
left |
number | Get the application left bound |
right |
number | Get the application right bound |
bottom |
number | Get the application bottom bound |
CapturePageOptions
Type:
- object
Properties:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
area |
Area |
<optional> |
The area of the window to be captured. |
|
format |
string |
<optional> |
'png' | The format of the captured image. Can be 'png', 'jpg', or 'bmp'. |
quality |
number |
<optional> |
100 | Number representing quality of JPEG image only. Between 0 - 100. |
Channel
Information for a Context Group. Contains metadata for displaying the group properly.
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
id |
string | Name of the context group |
displayMetadata |
DisplayMetadata | Metadata for the Context Group. Contains the group's human-readable name, color, and an image, as defined by the Interop Broker. |
type |
string | Defaults to system. |
broadcast |
function | Broadcasts a context for the channel. |
addContextListener |
function | Add a context handler for incoming context. |
getCurrentContext |
function | Gets the current context for the channel. |
ClientIdentity
The Identity for a Channel Client. Includes endpointId to differentiate between different connections for an entity.
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
uuid |
string | GUID of an application. |
name |
string | Name of an entity in an application. |
endpointId |
string | Unique differentiator for different Channel connections for an entity. |
ContentCreationRule
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
behavior |
string | 'view' | 'window' | 'browser' | 'block' |
match |
Array.<string> | List of match patterns. |
options |
object | Window creation options or View creation options. |
Context
Data passed between entities and applications.
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
id |
object |
<optional> |
An object containing string key-value pairs for the bulk of the data for the context. Differs between context types. |
name |
string |
<optional> |
User-readable name for the incoming context. |
type |
string | Conserved type for the context (e.g. |
ContextForIntent
Data passed between entities and applications, including an optional metadata.
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
id |
object |
<optional> |
An object containing string key-value pairs for the bulk of the data for the context. Differs between context types. |
name |
string |
<optional> |
User-readable name for the incoming context. |
type |
string | Conserved type for the context (e.g. |
|
metadata |
any |
<optional> |
ContextGroupInfo
Information for a Context Group. Contains metadata for displaying the group properly.
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
id |
string | Name of the context group |
displayMetadata |
DisplayMetadata | Metadata for the Context Group. Contains the group's human-readable name, color, and an image, as defined by the Interop Broker. |
ContextHandler()
Subscription function for addContextHandler.
ContextHandler(context, contextMetadataopt) → {void}
Parameters:
Name | Type | Attributes | Description |
---|---|---|---|
context |
Context | ||
contextMetadata |
ContextMetadata |
<optional> |
Returns:
- Type
- void
ContextMetadata
Metadata relating to a context or intent & context received through the addContextListener and addIntentListener functions. Currently identifies the app that originated the context or intent message.
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
source |
AppIdentifier | Identifier for the app instance that sent the context and/or intent. |
DefaultWindowOptions
Default window options apply to all platform windows. Any Window option is also a valid Default Window option used by default in any window that is created in the current platform's scope. Individual window options will override these defaults.
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
stylesheetUrl |
string |
<optional> |
Specify a path of a custom CSS file to be injected to all of the platform's windows. note: this option is only applied to windows that use the Default OpenFin Window. Windows with a specified url (Custom Windows) will not be affected by this option. |
DisplayMetadata
The display data for a Context Group.
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
name |
string | A user-readable name for this context group, e.g: |
|
color |
string |
<optional> |
The color that should be associated within this context group when displaying this context group in a UI, e.g: |
glyph |
string |
<optional> |
A URL of an image that can be used to display this context group |
Dpi
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
horizontal |
number |
<optional> |
The horizontal dpi |
vertical |
number |
<optional> |
The vertical dpi |
FindInPageOptions
Type:
- object
Properties:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
forward |
boolean |
<optional> |
true | Whether to search forward or backward. |
findNext |
boolean |
<optional> |
false | Whether to begin a new text finding session. Should be true for first requests, and false for subsequent requests. Defaults to false. |
matchCase |
boolean |
<optional> |
false | Whether search should be case-sensitive. |
wordStart |
boolean |
<optional> |
false | Whether to look only at the start of words. |
medialCapitalAsWordStart |
boolean |
<optional> |
false | When combined with wordStart, accepts a match in the middle of a word if the match begins with an uppercase letter followed by a |
GetAllClientsInContextGroupOptions
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
contextGroupId |
string | Name of the context group to get info for. |
GetContextOptions
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
contextType |
string |
<optional> |
Context Type |
getCurrentContext(contextTypeopt) → {Promise.<Context>}
A SessionContextGroup instance method for getting the current context of a certain type.
Parameters:
Name | Type | Attributes | Description |
---|---|---|---|
contextType |
string |
<optional> |
The Context Type to get. If not specified the last contextType set would get used. |
Returns:
- Type
- Promise.<Context>
GetInfoForContextGroupOptions
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
contextGroupId |
string | Name of the context group to get info for. |
Icon
Metadata relating to a single icon image at a remote URL, used to represent an application in a user interface.
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
src |
string | The fully qualified url to the icon. |
|
size |
string |
<optional> |
The dimensions of the Icon formatted as |
type |
string |
<optional> |
The media type of the icon. If not provided the Desktop Agent may refer to the src file extension. |
Image
Metadata relating to a single image at a remote URL, used to represent screenshot images.
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
src |
string | The fully qualified url to the image. |
|
size |
string |
<optional> |
The dimensions of the image formatted as |
type |
string |
<optional> |
The media type of the image. If not provided the Desktop Agent may refer to the src file extension. |
label |
string |
<optional> |
ImplementationMetadata
An interface that represents FDC3 implementation meta data.
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
fdc3Version |
string | The FDC3 version |
|
provider |
string | The provider uuid with prepend 'openfin' |
|
providerVersion |
string |
<optional> |
The provider runtime version |
ImplementationMetadata
Metadata relating to the FDC3 DesktopAgent object and its provider, including the supported version of the FDC3 specification, the name of the provider of the implementation, its own version number and the metadata of the calling application according to the desktop agent.
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
fdc3Version |
string | The FDC3 version |
|
provider |
string | The provider's uuid prepended with 'openfin' (e.g. 'openfin-myUuid'). |
|
providerVersion |
string |
<optional> |
The provider runtime version |
optionalFeatures |
ImplementationMetadataOptionalFeatures | ||
appMetadata |
AppMetadata | The calling application instance's own metadata, according to the Desktop Agent (MUST include at least the |
ImplementationMetadataOptionalFeatures
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
originatingAppMetadata |
boolean | Used to indicate whether the exposure of 'originating app metadata' for context and intent messages is supported by the Desktop Agent. |
userChannelMembershipAPIs |
boolean | Used to indicate whether the optional |
InfoForIntentOptions
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
name |
string | Name of the intent to get info for. |
|
context |
Context |
<optional> |
Optional context. |
InitLayoutOptions
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
containerId |
string |
<optional> |
The id attribute of the container where the window's Layout should be initialized. If not provided
then an element with id |
InitPlatformOptions
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
overrideCallback |
OverrideCallback |
<optional> |
a callback function that can be used to extend or replace default Provider behavior. |
Intent
The combination of an action and a context that is passed to an application for resolution.
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
name |
string | Name of the intent. |
context |
Context | Data associated with the intent |
IntentHandler()
Subscription function for registerIntentHandler
IntentHandler(context, contextMetadataopt) → {Promise.<IntentResult>|void}
Parameters:
Name | Type | Attributes | Description |
---|---|---|---|
context |
Context | ||
contextMetadata |
ContextMetadata |
<optional> |
Returns:
- Type
- Promise.<IntentResult> | void
IntentMetadata
The interface used to describe an intent within the platform.
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
name |
string | The unique name of the intent that can be invoked by the raiseIntent call. |
displayName |
string | A friendly display name for the intent that should be used to render UI elements. |
IntentResolution
IntentResolution provides a standard format for data returned upon resolving an Intent.
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
source |
TargetApp | identifier for the Application resolving the Intent (null if the Intent could not be resolved) |
|
data |
string |
<optional> |
Return data structure - if one is provided for the given Intent. |
version |
string | The version number of the Intents schema being used |
IntentResolution
Provides a standard format for data returned upon resolving an intent.
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
source |
AppIdentifier | Identifier for the app instance that was selected (or started) to resolve the intent. |
|
Intent |
string | Intent name |
|
version |
string |
<optional> |
The version number of the Intents schema being used. |
getResult |
function | Function that returns a promise that will resolve to either |
IntentResult
Describes results that an Intent handler may optionally return that should be communicated back to the app that raised the intent, via the IntentResolution.
Type:
InteropConfig
Information relevant to the Interop Broker.
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
currentContextGroup |
string |
<optional> |
Context Group for the client. (green, yellow, red, etc.) |
providerId |
string |
<optional> |
When provided, automatically connects the client to the specified provider uuid |
JoinContextGroupOptions
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
contextGroupId |
string | Id of the context group. |
|
target |
Identity | ClientIdentity |
<optional> |
Identity of the entity you wish to join to a context group. |
JumpListCategory
JumpListCategory interface
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
name |
string | The display title for the category. If omitted, items in this category will be placed into the standard 'Tasks' category. There can be only one such category, and it will always be displayed at the bottom of the JumpList. |
items |
Array.<JumpListItem> | Array of JumpListItem objects |
JumpListItem
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
type |
string | One of the following: "task" or "separator". Defaults to task. |
title |
string | The text to be displayed for the JumpList Item. Should only be set if type is "task". |
description |
string | Description of the task (displayed in a tooltip). Should only be set if type is "task". |
deepLink |
string | Deep link to a manifest, i.e: fins://path.to/manifest.json?$$param1=value1. See deep-linking for more information. |
iconPath |
string | 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). |
iconIndex |
number | 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. |
LayoutConfig
LayoutConfig interface
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
content |
Array.<LayoutItem> | Content of the layout. There can only be one top-level LayoutItem in the content array. We do not recommend trying to build Layouts or LayoutItems by hand and instead use calls such as getSnapshot or our Layout Config Generation Tool . |
settings |
LayoutSettings | Configuration for certain Layout behaviors. See the LayoutSettings interface. |
LayoutItem
Represents the arrangement of Views within a Platform window's Layout. We do not recommend trying to build Layouts or LayoutItems by hand and instead use calls such as getSnapshot or our Layout Config Generation Tool .
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
type |
string | The type of the item. Possible values are 'row', 'column', 'stack', and 'component'. |
|
content |
Array.<LayoutItem> |
<optional> |
An array of configurations for items that will be created as children of this item. |
componentName |
string |
<optional> |
Only a |
componentState |
View~options |
<optional> |
Only a |
LayoutPosition
Represents the position of an item in a layout relative to another. Possible values are 'top', 'bottom', 'left' and 'right'.
Type:
- string
LayoutSettings
Represents a potential ways to customize behavior of your Layout
Type:
- object
Properties:
Name | Type | Attributes | Default | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
constrainDragToHeaders |
boolean |
<optional> |
false | Limits the area to which tabs can be dragged. If true, stack headers are the only areas where tabs can be dropped. |
||||||||
hasHeaders |
boolean |
<optional> |
true | Turns tab headers on or off. If false, the layout will be displayed with splitters only. |
||||||||
newTabButton |
object |
<optional> |
Configuration of the Plus button that appears on each tabstrip. Upon pressing, a new tab will be added to the tabstrip with the specified url. Properties
|
|||||||||
popoutWholeStack |
boolean |
<optional> |
false | Whether the popout button will only act on the entire stack, as opposed to only the active tab. |
||||||||
preventDragIn |
boolean |
<optional> |
false | If true, tabs can't be dragged into the window. |
||||||||
preventDragOut |
boolean |
<optional> |
false | If true, tabs can't be dragged out of the window. |
||||||||
preventSplitterResize |
boolean |
<optional> |
false | If true, tab contents can't be resized by the user. |
||||||||
reorderEnabled |
boolean |
<optional> |
true | If true, the user can re-arrange the layout by dragging items by their tabs to the desired location. |
||||||||
showCloseIcon |
boolean |
<optional> |
false | Whether to show the close button on stack header (not to be confused with close button on every tab). |
||||||||
showMaximiseIcon |
boolean |
<optional> |
false | Whether to show the maximize button on stack header. The button will maximize the current tab to fill the entire window. |
||||||||
showPopoutIcon |
boolean |
<optional> |
false | Whether to show the popout button on stack header.
The button will create a new window with current tab as its content.
In case |
Listener
Listener object returned by addContextListener and addIntentListener
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
unsubscribe |
function | function for addContextListener and addIntentListener. |
Margins
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
marginType |
string |
<optional> |
Can be |
top |
number |
<optional> |
The top margin of the printed web page, in pixels. |
bottom |
number |
<optional> |
The bottom margin of the printed web page, in pixels. |
left |
number |
<optional> |
The left margin of the printed web page, in pixels. |
right |
number |
<optional> |
The right margin of the printed web page, in pixels. |
MenuItemTemplate
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
data |
* | Data to be returned if the user selects the element. Must be serializable. Large objects can have a performance impact. |
|
type |
'normal' | 'separator' | 'submenu' | 'checkbox' |
<optional> |
Defaults to 'normal' unless a 'submenu' key exists |
label |
string |
<optional> |
The text to show on the menu item. Should be left undefined for |
enabled |
boolean |
<optional> |
If false, the menu item will be greyed out and unclickable. |
visible |
boolean |
<optional> |
If false, the menu item will be entirely hidden. |
checked |
boolean |
<optional> |
Should only be specified for |
submenu |
Array.<MenuItemTemplate> |
<optional> |
Should be specified for |
MenuResult
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
result |
'clicked' | 'closed' | Whether the user clicked on a menu item or the menu was closed (user clicked elsewhere). |
|
data |
* | undefined |
<optional> |
The data property of the menu item clicked by the user. Only defined if result was |
Opacity
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
duration |
number | The total time in milliseconds this transition should take. |
relative |
boolean | Treat 'opacity' as absolute or as a delta. Defaults to false. |
opacity |
number | This value is clamped from 0.0 to 1.0. |
PlatformOptions
The options object required by Platform.start Any Application option is also a valid platform option
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
commands |
Array.<Object> |
<optional> |
Configuration for keyboard commands. For details and usage, see Using Keyboard Commands. |
defaultWindowOptions |
DefaultWindowOptions |
<optional> |
Default window options apply to all platform windows. |
defaultViewOptions |
View~options |
<optional> |
Default view options apply to all platform views. |
viewProcessAffinityStrategy |
ProcessAffinityStrategy |
<optional> |
'same' | 'different'. |
PopupOptions
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
name |
string |
<optional> |
If a window with this |
url |
string |
<optional> |
Navigates to this |
initialOptions |
Window~options |
<optional> |
Window creation options when using |
additionalOptions |
Window~options |
<optional> |
Updatable window options applied to new and existing windows when shown as popups. |
onPopupResult |
function |
<optional> |
Executed when this window's popup calls |
onPopupReady |
function |
<optional> |
Executed when the popup window is shown. Provides the popup window to the provided function, and allows for easy access the popup window for additional behavior customization. |
height |
number |
<optional> |
Height of the popup window (takes priority over |
width |
number |
<optional> |
Width of the popup window (takes priority over |
x |
number |
<optional> |
Left position where the popup window will be shown (relative to the window calling |
y |
number |
<optional> |
Top position where the popup window will be shown (relative to the window calling |
blurBehavior |
'modal' | 'hide' | 'close' |
<optional> |
Determines what happens if the popup window is blurred. 'modal' restricts resizing and positioning in the caller, 'hide' hides the popup window on blur and 'close' closes the popup window on blur. |
resultDispatchBehavior |
'none' | 'hide' | 'close' |
<optional> |
Determines what happens when the popup window calls |
focus |
boolean |
<optional> |
Determines if the popup window should or should not be focused when it is shown. |
hideOnClose |
boolean |
<optional> |
Hide the popup window instead of closing whenever |
PopupResult
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
identity |
Identity |
|
|
result |
'clicked' | 'dismissed' | Result of the user interaction with the popup window. |
|
data |
* | undefined |
<optional> |
Data passed to |
Position
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
duration |
number | The total time in milliseconds this transition should take. |
relative |
boolean | Treat 'opacity' as absolute or as a delta. Defaults to false. |
left |
number | Defaults to the window's current left position in virtual screen coordinates. |
top |
number | Defaults to the window's current top position in virtual screen coordinates. |
PresetLayoutOptions
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
presetType |
LayoutPresetTypes | Which preset layout arrangement to use.
The preset options are |
PrinterInfo
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
name |
string | Printer Name |
description |
string | Printer Description |
status |
number | Printer Status |
isDefault |
boolean | Indicates that system's default printer |
PrintOptions
Type:
- object
Properties:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
silent |
boolean |
<optional> |
false | Don't ask user for print settings. |
printBackground |
boolean |
<optional> |
false | Prints the background color and image of the web page. |
deviceName |
string |
<optional> |
'' | Set the printer device name to use. |
color |
boolean |
<optional> |
true | Set whether the printed web page will be in color or grayscale. |
margins |
Margins |
<optional> |
Set margins for the printed web page |
|
landscape |
boolean |
<optional> |
false | Whether the web page should be printed in landscape mode. |
scaleFactor |
number |
<optional> |
The scale factor of the web page. |
|
pagesPerSheet |
number |
<optional> |
The number of pages to print per page sheet. |
|
collate |
boolean |
<optional> |
Whether the web page should be collated. |
|
copies |
number |
<optional> |
The number of copies of the web page to print. |
|
pageRanges |
Record.<string, number> |
<optional> |
The page range to print. Should have two keys: from and to. |
|
duplexMode |
string |
<optional> |
Set the duplex mode of the printed web page. Can be simplex, shortEdge, or longEdge. |
|
dpi |
Dpi |
<optional> |
Set dpi for the printed web page |
PrivateChannel
Object representing a private context channel, which is intended to support secure communication between applications, and extends the Channel interface with event handlers which provide information on the connection state of both parties, ensuring that desktop agents do not need to queue or retain messages that are broadcast before a context listener is added and that applications are able to stop broadcasting messages when the other party has disconnected.
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
id |
string | Private Channel Id |
|
type |
string | Channel Type |
|
displayMetadata |
DisplayMetadata |
<optional> |
|
broadcast |
function | ||
getCurrentContext |
function | ||
addContextListener |
function | ||
onAddContextListener |
function | ||
onUnsubscribe |
function | ||
onDisconnect |
function | ||
disconnect |
function |
ProcessAffinityStrategy
Strategy to place views that share a domain into different process affinities or the same process affinity.
Type:
- same | different
Properties:
Name | Type | Description |
---|---|---|
same |
string | views in the same domain will have the same process affinity. |
different |
string | views in the same domain will have different process affinities. |
RemoveFromContextGroupOptions
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
target |
Identity | ClientIdentity | Identity of the entity you wish to join to a context group. |
SessionContextGroup
An instance of a SessionContextGroup
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
id |
string | The SessionContextGroup's id. |
setContext |
setContext | Sets a context of a certain type |
getCurrentContext |
getCurrentContext | Gets the currently set context of a certain type |
addContextHandler |
addContextHandler | Adds a handler for context change. |
setContext(context) → {Promise.<void>}
A SessionContextGroup instance method for setting a context in the SessionContextGroup.
Parameters:
Name | Type | Description |
---|---|---|
context |
Context | The Context to be set. |
Returns:
- Type
- Promise.<void>
SetContextOptions
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
{context} |
Context | New context to set. |
SharedWorkerInfo
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
id |
string | The unique id of the shared worker. |
url |
string | The url of the shared worker. |
ShowPopupMenuOptions
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
template |
Array.<MenuItemTemplate> | An array describing the menu to show. |
|
x |
number |
<optional> |
The window x coordinate where to show the menu. Defaults to mouse position. If using must also use |
y |
number |
<optional> |
The window y coordinate where to show the menu. Defaults to mouse position. If using must also use |
ShowViewsOnSplitterDrag
Platform Windows Only. Allows views to be shown when they are resized by the user dragging the splitter between layout stacks.
Type:
- Object
Properties:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
enabled |
boolean |
<optional> |
false | Enables or disables showing views when the layout splitter is being dragged. |
ShowViewsOnTabDrag
Platform Windows Only. Allows views to be shown when the user is manipulating the layout by repositioning a tab.
Type:
- Object
Properties:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
enabled |
boolean |
<optional> |
false | Enables or disables showing views when a tab is being dragged. |
ShowViewsOnWindowResize
Platform Windows Only. Enables views to be shown when a Platform Window is being resized by the user.
Type:
- Object
Properties:
Name | Type | Attributes | Default | Description |
---|---|---|---|---|
enabled |
boolean |
<optional> |
false | Enables or disables showing Views when a Platform Window is being resized. |
paintIntervalMs |
number |
<optional> |
0 | Number of miliseconds to wait between view repaints. |
Size
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
duration |
number | The total time in milliseconds this transition should take. |
relative |
boolean | Treat 'opacity' as absolute or as a delta. Defaults to false. |
width |
number | Optional if height is present. Defaults to the window's current width. |
height |
number | Optional if width is present. Defaults to the window's current height. |
Snapshot
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
windows |
Array.<WindowOption> | The array of window options objects |
SnapshotProvider
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
getSnapshot |
getSnapshot |
<optional> |
|
applySnapshot |
applySnapshot |
<optional> |
StackCreationOptions
Stack creation options.
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
position |
LayoutPosition |
<optional> |
The position to create the new TabStack in, relative to the given adjacent TabStack. Defaults to 'right'. |
Subscription
Object returned when subscribing a handler.
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
unsubscribe |
function | Function to unsubscribe the handler. |
TargetApp
Some operations can identify an app just by its name, or pass full app metadata.
Type:
- string | AppMetadata
Transition
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
opacity |
Opacity | The Opacity transition |
position |
Position | The Position transition |
size |
Size | The Size transition |
TransitionOptions
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
interrupt |
boolean | This option interrupts the current animation. When false it pushes this animation onto the end of the animation queue. |
relative |
boolean | Treat 'opacity' as absolute or as a delta. Defaults to false. |
ViewVisibility
Platform Windows Only. Controls behavior for showing views when they are being resized by the user.
Type:
- Object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
showViewsOnWindowResize |
ShowViewsOnWindowResize |
<optional> |
Enables views to be shown when a Platform Window is being resized by the user. |
showViewsOnSplitterDrag |
ShowViewsOnSplitterDrag |
<optional> |
Allows views to be shown when they are resized by the user dragging the splitter between layout stacks. |
showViewsOnTabDrag |
ShowViewsOnTabDrag |
<optional> |
Supported on Windows Operating Systems only. Allows views to be shown when the user is dragging a tab around a layout. |
WriteRequestType
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
data |
string | Data to be written |
|
type |
string |
<optional> |
Clipboard Type |