Syntax Reference

Display Boxes and Display JSL Functions contains a summary of common display boxes that appear in reports. The JSL function to create each display box is listed for those that can also be constructed. Many display boxes cannot be constructed through JSL, but are still part of the display tree that can be accessed through JSL.

For information about additional display boxes, see the JMP Scripting Index. (Select Scripting Index from the JMP Help menu.)

Display Boxes and Display JSL Functions
Box Type	JSL Function	Description
Axis Box		Contains the axis settings such as tick marks, tick labels, axis labels, and label orientation.
Border Box	Border Box(<Left(pixels)>, <Right(pixels)>, <Top(pixels)>, <Bottom(pixels)>, <Sides(0)>, db)	A container that can be used to add space on one, two, three, or all four sides.
Button Box	Button Box("title", <<Set Icon("path"), script)	Constructs a button with the title and executes the script when the button is clicked.
Cat Axis Box		An axis box for a categorical axis.
Cell Plot Box		Contains a cell plot.
Center Box		Centers the display box that it contains.
Check Box	Check Box(list, <script>)	Constructs a display box to show one or more check boxes.
Check Box Box		Contains a single check box within the check box.
Col List Box	Col List Box(<Data Table(<name>)>, <all\|character\|numeric>, <width(pixels)>, <grouped>, <maxSelected(n)>, <nlines(n)>, <MaxItems(n)>, <MinItems(n)>, <On Change(expr)>, <script>)	Constructs a display box to show a list box that allows selection of data table columns. Creates a List Box Box to hold the list of columns.
Combo Box	Combo Box(list, <script>)	Constructs a display box to show a combo box with a menu.
Context Box	Context Box(displayBox, ...)	Defines a scoped evaluation context. Each Context Box is executed independently of each other. Creates an Eval Context Box.
Crosstab Box		Container for a contingency table.
Display 3D Box		Container for a three-dimensional Scene Box.
Excerpt Box	Excerpt Box(report, subscripts)	Returns a display box containing the excerpt designated by the report held at number report and the list of display subscripts subscripts. The subscripts reflect the current state of the report, after previous excerpts have been removed.
Expr As Picture	Expr As Picture(expr(...), <width(pixels)>)	Converts expr() to a picture as it would appear in the Formula Editor. Creates a Pict Box.
Frame Box		Contains a graphics frame.
Global Box	Global Box(global)	Constructs a box to display the current value of the global variable; the value is directly editable, and editing the value automatically forces graphs to update.
Graph 3D Box	Graph 3D Box(properties)	Constructs a display box with 3-D content. Creates a Scene Box.
Graph Box	Graph Box(properties, script)	Constructs a graph with axes. Might create display boxes such Axis Box and Frame Box.
H Center Box	H Center Box(display box)	Returns a display box with the display box argument centered horizontally with respect to all other sibling display boxes. Creates a Center Box.
H List Box	H List Box(display box, ...)	Creates a display box that contains other display boxes and displays them horizontally. Creates a List Box.
H Sheet Box	H Sheet Box(<<Hold(report), display boxes)	Returns a display box that arranges the display boxes provided by the arguments in a horizontal layout. The <<Hold() message tells the sheet to own the report(s) that are excerpted.
HierBox	Hier Box("text", Hier Box(...), ...)	Constructs a node of a tree (similar to Diagram output) containing text. Hier Box can contain additional Hier Boxes, allowing you to create a tree. The text can be a Text Edit Box.
Icon Box	Icon Box("name")	Constructs a display box containing an icon, where the argument is a name such as Popup, Locked, Labeled, Sub, Excluded, Hidden, Continuous, Nominal, or Ordinal. The argument can also be a path to an image.
If Box	If Box(Boolean, display boxes)	Constructs a display box whose contents are conditionally displayed.
Journal Box	Journal Box("Journal Text")	Constructs a display box that displays the quoted string journal box. We recommend that you do not generate the journal text by hand.
Lineup Box	Lineup Box(<NCol(n)>, <Spacing(pixels, <vspace>)>, display boxes, ...)	Constructs a display box to show an alignment of boxes in n columns.
List Box	List Box({"item", ...}, <width(pixels)>, <maxSelected(n)>, <nLines(n)>, <script>)	Creates a display box to show a list box of selection items. The argument can be a list of two-item lists containing the item name and a string that specifies the modeling type or sorting order. The icon appears next to the corresponding item in the list box.
List Box Box		Created by Col List Box().
Matrix Box	Matrix Box(matrix)	Displays the matrix given in the usual array form.
Number Col Box	Number Col Box("title", numbers)	Creates a column named title with numeric entries given in list or matrix form.
Number Col Edit Box	Number Col Edit Box("title", numbers)	Creates a column named title with numeric entries given in list or matrix form. The numbers can be edited.
Number Edit Box	Number Edit Box(value)	Creates an editable number box that initially contains the value argument.
Outline Box	Outline Box("title", display box, ...)	Creates a new outline named title containing the listed display boxes.
Page Break Box	Page Break Box()	Creates a display box that forces a page break when the window is printed.
Panel Box	Panel Box("title", display box)	Creates a display box labeled with the quoted string title that contains the listed display boxes.
Pict Box		Contains a picture object. Created by any function that places a picture into a report window (for example, Picture Box()).
Picture Box	Picture Box(Open(picture), format)	Constructs a box that does nothing except mark the position where pictures are taken when converted to pictures and text, as in outputting to a word processing file.
Plot Col Box	Plot Col Box("title", numbers)	Returns a display box labeled with the quoted string title to graph the numbers. The numbers can be either a list or a matrix.
Popup Box	Popup Box({"command1", script1, "command2", script2, "",...})	Creates a red triangle menu. The single argument is an expression yielding a list of an even number of items alternating between the command string and the expression that you want evaluated when the command is selected. If the command is an empty string, a separator line is inserted.
Radio Box	Radio Box({"item", ...}, <script>)	Constructs a display box to show a set of radio buttons. The optional script is run every time a radio button is selected.
Range Slider Box	Range Slider Box(min, max, low_val, high_val, script)	Creates an interactive slider control with a low and high variable sliders.
Scene Box	Scene Box(x size, y size)	Creates an x by y-sized scene box for 3-D graphics.
Script Box	Script Box(<script>, <width>, <height>)	Constructs an editable box that contains the quoted string script. The editable box is a script window and can both be edited and run as JSL.
Scroll Box	Scroll Box(<size(h,v)>, <flexible(Boolean)>, displayBox, ...)	Creates a display box that positions a larger child box using scroll bars.
Sheet Box		Container for one or more Sheet Panel Boxes.
Sheet Panel Box		Container for a single panel of a sheet layout.
Sheet Part	Sheet Part("title", display box)	Returns a display box containing the display box argument with the quoted string title as its title.
Slider Box	Slider Box(min, max, global variable, script, <set width(n)>, <rescale slider(min, max)>)	Creates an interactive slider control.
Spacer Box	Spacer Box(<size(h,v)>, <color(color)>)	Creates a display box that can be used to maintain space between other display boxes, or to fill a cell in a LineUp Box.
String Col Box	String Col Box("title", {"string", ...})	Creates a column in the table containing the string items listed.
String Col Edit Box	String Col Edit Box("title", {"string", ...})	Creates a column in the table containing the string items listed. The string boxes are editable.
Tab Box	Tab Box("page title1", contents of page 1, "page title 2", contents of page 2, ...)	Creates a tabbed window pane. The arguments are an even number of items alternating between the name of a tab page and the contents of the tab page. Creates a Tab List Box.
Table Box	Table Box(display box, ...)	Creates a report table with the display boxes listed as columns.
Tab List Box		Contains Tab Pane boxes. Created by Tab Box. Note: This function is used for subscripting.
Tab Pane Box		Contains the display boxes shown on a single tab pane in a tab box. Note: This function is used for subscripting.
Text Box	Text Box("text", <arguments>)	Constructs a box that contains the quoted string text.
Text Edit Box	Text Edit Box("text", <arguments>)	Constructs an editable box that contains the quoted string text. The optional script argument attaches a script to the text box, either by adding the script as a second argument, or by sending the Set Script message.
V Center Box	V Center Box(display box)	Returns a display box with the display box argument centered vertically with respect to all other sibling display boxes. Creates a Center Box.
V Sheet Box	V Sheet Box(<<Hold(report), display boxes)	Returns a display box that arranges the display boxes provided by the arguments in a vertical layout. The <<Hold() message tells the sheet to own the report(s) that is excerpted.
Web Browser Box	Web Browser Box(url)	Creates a display box that contains a web page. Available only on Windows.

Subscripts for a Display Box
Symbol	Syntax	Explanation
[ ]	db["text"]	Finds the outline in db that has the title text. Note that text must be the complete title, not just a substring of the title, but you can use ’?’ as a wildcard character with a substring to match the rest of the title. For example, "? Estimates" to find "Parameter Estimates". See Display Box Object References for details.
	db[Outline Box("text")]	Finds the outline box containing the text.
	db[Column Box("name")	Finds the column box containing the text.
	db[boxType(n)]	Finds the nth display box of type boxType.
	db[arg1, arg2, arg3, ...]	Matches the last argument to a display box that is contained by the penultimate argument’s outline node, which is in turn contained by the antepenultimate argument, and so on. In other words, it is a way of digging down the generations of an outline tree to identify a nested display box.