For the latest version of JMP Help, visit JMP.com/help.


Scripting Guide > Display Trees
Publication date: 06/21/2023

Display Trees

Create and Interact with Windows

After you learn the basics of scripting, you’re ready to manipulate JMP reports and create new JMP windows. This chapter focuses on the following topics:

navigating JMP display trees to manipulate items in report windows

building new windows with custom results

building modal windows

interacting with the script editor

converting deprecated Dialog() scripts to New Window() scripts

Display Tree Compatibility Issues

JMP platforms are generally stable from release to release. However, sometimes the structure of reports changes in major releases. When this happens, old scripts can fail because of the new structure. To avoid the continual updating of old scripts, write scripts so that they avoid dependence on the report structure. Using a string to index a box, followed by a numbered subscript to pick a specific child box, is most reliable across releases. See Create a Reference by Subscripting. See Compatibility Notes for compatibility issues in JMP 17.

Note: This chapter shows how to create and use the most common display boxes. All display boxes are documented in the JMP Scripting Index, which is available in the Help menu.

Contents

Structure of JMP Reports

Examples of Display Boxes
Show the Display Tree
Edit Display Box Properties
Get References to Display Box Objects
Send Messages to Display Boxes
Example of Creating a Report

Construct Custom Windows

Example of Creating a Graph Box
Extract Values from a Window
Construct Display Boxes for New Windows
Close a Window
Add and Delete Display Boxes
Set Function and Set Script
Get and Set Selected Values of Display Elements That Return Lists
Send Messages to Constructed Displays
Construct Display Boxes That Contain Platforms
Counting the Number of Child Boxes
Examples of Creating a Dashboard from Two Reports
Example of Creating a Cluster Platform Launch Window
Example of Constructing a Custom Platform
Example of Specifying Text and Background Colors

Modal Windows in JSL

Construct a Modal Window
Construct a Column Dialog
Comparison of Column Dialog and New Window
Constructors for Column Dialogs

Convert Deprecated Dialog to New Window

New Window Example
Example of Deprecated Dialog
Differences Between New Window and the Deprecated Dialog
Optional Scripts in New Window

Scripting the Script Editor

Technical Details for Display Trees

Want more information? Have questions? Get answers in the JMP User Community (community.jmp.com).