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


Scripting Guide > Display Trees > Technical Details
Publication date: 11/29/2021

Technical Details

Write Tab Box and Tab Page Box Scripts

Tab Page Box() organizes the title and contents of the page in one display box. When Tab Page Box() is inside Tab Box(), a tabbed window with multiple tabbed pages appears. See Tab Box and Tab Page Box.

In previous versions of JMP, display boxes such as V List Box() contained tab contents. Consider the following script:

win = New Window( "Tab Box",
	tb = Tab Box(
		"First page", // name of the tab
		V List Box( // tab contents
			Text Box( "first line of first page" ),
			Text Box( "second line of first page" )
		),
		"Second page", // name of the tab
		V List Box( // tab contents
			Text Box( "first line of second page" ),
			Text Box( "second line of second page" )
		),
	)
);

We recommend that Tab Box() contain a Tab Page Box() for each tab. The preceding example is rewritten as follows:

win = New Window( "Tab Box",
	tb = Tab Box(
		Tab Page Box( // tab contents
			Title( "First page of my tab box" ), // name of the tab
			Text Box( "first line of first page" ),
			Text Box( "second line of first page" )
		),
		Tab Page Box( // tab contents
			Title( "Second page" ), // name of the tab
			Text Box( "first line of second page" ),
			Text Box( "second line of second page" )
		)
	)
);

Note: Tab Page Box() requires that the title be defined in a Title() function.

When a tab page box is created or dragged outside a tab box, the tab page box is a stand-alone container. The title appears in a shaded box at the top of the page, similar to the title in Sheet Part(); the title does not appear in an interactive tab. Dashboard with One Row of Reports provides an example.

Deprecated Tab Box and Tab Page Box Messages

Some messages previously used for Tab Box() are deprecated. Their counterparts are compatible with Tab Page Box().

Table 11.5 Deprecated Tab Box() Messages

Deprecated Tab Box Message

Current Tab Page Box Message

Set Title

Title

Set Tip

Tip

Set Icon

Icon

Set Closeable

Closeable

See Tab Box and Tab Page Box for more information about the two display boxes.

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