display.screen.write()

 

This method writes a screen defined as a record format in a Rich Display File to the browser or a mobile device. The user is not prompted to respond to the screen until a display.screen.read() is issued.

The method is typically used when multiple overlaid formats are displayed; otherwise, display.screen.execute() can be used in place of separate calls to display.screen.write() and display.screen.read().

Parameter

  1. Data structure (optional) - A Profound.js data structure reference. If specified, the screen is populated with values from the data structure. If not specified, global fields are used to send values to the screen. If the data structure is not qualified, you must wrap the parameter with the pjs.ds() API.

  2. Message (optional) - Additional information sent to the screen's onmessage event. The message can be supplied using any primitive JavaScript value, including Strings, Objects, and Arrays.

Example

// Declare Rich Display File pjs.defineDisplay("mydisplay.js"); // Write 3 overlaid screens mydisplay.top.write(); mydisplay.middle.write(); mydisplay.bottom.write(); // Read user input mydisplay.top.read(); mydisplay.middle.read(); mydisplay.bottom.read();

RPG Equivalent

WRITE