VisualFrame.setField(field)

Specifies the field (column) associated with this VisualFrame. The corresponding “getter” function is getField().

Parameter

field: name of the column (String)

Example

Chart Component Script

dataset = [["State", "Quantity"], ["NJ",200], ["NY",300]]; (1)
graph = new EGraph();
var elem = new IntervalElement("State", "Quantity");
var frame = new BrightnessColorFrame(); (2)
frame.setField("Quantity"); (3)
frame.setColor(java.awt.Color(0xff0000));
elem.setColorFrame(frame); (4)
graph.addElement(elem);

1	See dataset to use a data block instead of an array literal.
2	Create the `VisualFrame` object.
3	Use `setField` to specify the field for the `VisualFrame`.
4	Use GraphElement.setColorFrame(frame) to add the `VisualFrame` to the IntervalElement.

VisualFrameSetField

Script that modifies the graph or dataset properties should be placed on the Chart component itself. See Add Component Script for more information. This script has access to the Chart data and Chart API methods. Scripted Charts are not good candidates for user-modification, so you should deselect ‘Enable Ad Hoc Editing’ in the Chart Properties dialog box.

To change the property on a Chart that was previously created with the Chart Editor, use “getter” methods such as EGraph.getElement(index) ① and GraphElement.getColorFrame() ② to obtain a handle to the desired GraphElement and ColorFrame. For example:

var elem = graph.getElement(0); (1)
var frame = elem.getColorFrame(); (2)
// Compact syntax: var frame = graph.getElement(0).getColorFrame();

frame.setField("Customer:Company");