DDPrefix

Syntax graph.DDPrefix(URL)

Description Specifies a drill-down string for all data items in your graph.

This function can also be used to specify a prefix for all URL addresses or JavaScript functions passed to any subsequent Graph. DDEnable methods. If all of the web pages to which you drill-down share a common URL prefix, this method will help shorten your PCScript command string.

You should use this method only if all of the URLs have a common prefix, including the JavaScript functions. Otherwise, this prefix will be placed in front of links or functions that shouldn't have this prefix, rendering them invalid.

Note that this method effects only subsequent Graph. DDEnable method calls, meaning that any Graph. DDEnable method calls that appear before the Graph.DDPrefix method call will ignore the prefix. Also, you can use more than one Graph.DDPrefix, with the most recent prefix overriding any previous prefixes. One strategy that this allows for is breaking up your Graph. DDEnable method calls according to prefix, as demonstrated in Example 5.16.

Parameters Graph.DDPrefix accepts the following parameters.

URL

String

Your drill-down string, or the prefix that PopChart Server should prepend to any URL addresses or JavaScript functions in subsequent Graph. DDEnable method calls.

Example 5.15 Creating a Drill-Down Prefix

graph.DDPrefix(http://webapp.mycompany.com/drilldown?)

Example 5.16 Using DDPrefix Multiple Time in the Same Graph

graph.DDPrefix(http://www.myserver.com/newgraphs/)

graph.DDEnable(8, 13, profits.html)

graph.DDPrefix(javascript:)

graph.DDEnable(1, 1-20, popupwindow(net); 2, 1-20, calculate(2,54,gross))

Example 5.16 shows two Graph.DDPrefix and Graph. DDEnable method calls. The effect of the first graph.DDPrefix method call is that the first graph.DDEnable drills-down to http://www.myserver.com/newgraphs/profits.html (not profits.html, as it would if there were no graph.DDPrefix command). The effect of the second graph.DDPrefix method call is that all drill-down URLs in the second graph.DDEnable method call are preceded by javascript:, making them JavaScript functions.