Java Graphics Action On New Plot

DESCRIPTION:

Sets and reads the "new plot action", which controls how the Java graphics device handles a new plot. The "Graph Options" dialog allows setting this option manually; this function allows reading and changing the same option programmatically.

USAGE:

java.new.plot.action(action="")

OPTIONAL ARGUMENTS:

action
the "new page action", specified as one of the strings "delete", "new", or "reuse". If this is any other string, the current value is returned without changing it.

VALUE:

One of the strings "delete", "new", or "reuse", the old value for the "new plot" option.

SIDE EFFECTS:

Sets the "new plot action" behavior for the java.graph device window. This is a global option that applies to all open java.graph devices.

DETAILS:

The java.graph device window displays multiple tabbed pages. The "new plot action" specifies how the device window should respond when Spotfire S+ attempts to create a new high-level graphic.

If this option is "delete", the first time that a new high-level graphic is generated within a top-level expression, all existing pages in the window are deleted and a new page is created. Additional new high-level graphics within the same top-level expression create additional pages.

If this option is "new", whenever a new high-level graphic is generated, a new page is created.

If this option is "reuse", whenever a new high-level graphic is generated, the current page is cleared and reused.

EXAMPLES:

java.new.plot.action("delete")
{plot(1);plot(2)}  # remove tabs, then create two tabs
plot(1:2)          # remove tabs, then create one tab
java.new.plot.action("new")
{plot(1);plot(2)}  # add two new tabs
plot(1:2)          # add one more new tab
java.new.plot.action("reuse")
{plot(1);plot(2)}  # reuse the current tab
plot(1:2)          # reuse the current tab