/**
* Creates a new series with the specified key. Note that the series key cannot be changed after
* it has been set in the constructor - this is by design, to ensure that each series in a {@link
* XYZSeriesCollection} always has a unique key. For the same reason, the key type should be an
* immutable class.
*
* @param key the key ({@code null} not permitted).
*/
public XYZSeries(K key) {
ArgChecks.nullNotPermitted(key, "key");
this.key = key;
this.items = new ArrayList<XYZDataItem>();
this.listeners = new EventListenerList();
this.notify = true;
}
/**
* Sets the highlight color.
*
* @param color the color (<code>null</code> not permitted).
*/
public void setHighlightColor(Color color) {
ArgChecks.nullNotPermitted(color, "color");
this.highlightColor = color;
}
/**
* Sets the style that will be used when creating new charts.
*
* @param style the style ({@code null} not permitted).
* @since 1.2
*/
public static void setDefaultChartStyle(ChartStyle style) {
ArgChecks.nullNotPermitted(style, "style");
defaultStyle = style.clone();
}
/**
* Adds a new data item to the series and sends a {@link Series3DChangeEvent} to all registered
* listeners.
*
* @param item the data item ({@code null} not permitted).
*/
public void add(XYZDataItem item) {
ArgChecks.nullNotPermitted(item, "item");
this.items.add(item);
fireSeriesChanged();
}
/**
* Removes a listener from the list of objects listening for chart mouse events.
*
* @param listener the listener ({@code null} not permitted).
* @since 1.3
*/
public void removeChartMouseListener(Chart3DMouseListener listener) {
ArgChecks.nullNotPermitted(listener, "listener");
this.chartMouseListeners.remove(Chart3DMouseListener.class, listener);
}