LegendSpec.setPreferredSize(value)

Specifies the legend size (pixels) for cases when EGraph.setLegendLayout(value) is set to Chart.IN_PLACE. The corresponding “getter” function is getPreferredSize().

Parameter

value

a java.awt.Dimension object

Example

Chart Component Script
dataset = [["State", "Quantity"], ["NJ",200], ["NY",300]]; (1)
graph = new EGraph();
var elem = new IntervalElement("State", "Quantity");
var frame = new CategoricalColorFrame();
frame.setField("State");
var spec = new LegendSpec(); (2)
spec.setPosition(java.awt.Point(50,245)); // in pixels
spec.setPreferredSize(java.awt.Dimension(100,40)); (3)
frame.setLegendSpec(spec); (4)
elem.setColorFrame(frame);
graph.setLegendLayout(Chart.IN_PLACE);
graph.addElement(elem);
1 See dataset to use a data block instead of an array literal.
2 Create the LegendSpec object.
3 Use setPreferredSize to assign the size.
4 Use VisualFrame.setLegendSpec(spec) to assign the LegendSpec object to the ColorFrame.

LegendSpecExamplesetPreferredSize

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();

var spec = new LegendSpec();
spec.setPosition(java.awt.Point(50,245)); // in pixels
spec.setPreferredSize(java.awt.Dimension(100,40));
frame.setLegendSpec(spec);
graph.setLegendLayout(Chart.IN_PLACE);