OpenDisplayAsync function

OpenDisplayAsync() opens the specified display, optional additional context information, and optional initial placement rules.

Arguments

1-4, Optional arguments are indicated by a ? following the argument name.

Argument	Description
`DisplayName`	A literal or graphics expression that resolves to the name of a display.
`placement?`	A Placement object or array of Placement objects whose values define the initial placement of the display when it opens. The Placement objects override the default pop-up window placement rules.
`X?`	A number indicating the X coordinates for the display's trigger point.
`Y?`	A number indicating the Y coordinates for the display's trigger point.

Return values (Promise object that resolves to a Boolean)

True, if <DisplayName> (case-insensitive) matches a published display available to be opened by this instance of DeltaV Live.
False, otherwise.

Syntax

DL.OpenDisplayAsync(displayName, 
				  placement?[], 
				  X?, 
				  Y?)

Examples

Example Result

Example	Result
`if (!await DL.OpenDisplayAsync(DL.DN("Reactor4"))) { // do something dealing with the display not being found } // direct display to open at bottom-center of the "OVVW" Screen // for Layouts that have it let pos = new Placement(PlacementOption.Screen, "OVVW"); pos.UseCachedPosition = false; pos.Alignment = PlacementAlignment.Bottom \| PlacementAlignment.Center; DL.OpenDisplayAsync(DL.DN("EnergyUse”), [pos]);`

if (!await DL.OpenDisplayAsync(DL.DN("Reactor4"))) {
     // do something dealing with the display not being found
}
// direct display to open at bottom-center of the "OVVW" Screen // for Layouts that have it
let pos = new Placement(PlacementOption.Screen, "OVVW");
pos.UseCachedPosition = false;
pos.Alignment =
     PlacementAlignment.Bottom | PlacementAlignment.Center;
DL.OpenDisplayAsync(DL.DN("EnergyUse”), [pos]);

Note:

It is recommended that you use the DL.DN() function for the display name to enable display and display frame rename tracking.