ReadonlyisFor runtime type checking.
Adds listeners to the selection.
The listeners to add.
Optionaloptions: IListener.Options
Options for the listeners.
A function to remove the listeners.
Empties the selection.
Returns the item selected most recently, or null when the selection is empty.
Returns the chart the selected elements are of, or null when the selection is empty.
Returns what every selected item shares as its parent: null for the root (the sheet, the
chart), else the group or element they are in.
Returns the selected items, in the order the selection keeps them.
Returns true if nothing is selected.
Returns true if other selects the same items, with the same one active.
Selects elements, replacing the selection.
The elements to select, the last one the active one. All of one chart.
Optionaloptions: IChartElementSelection.SelectOptions
With add, extends the selection instead.
Selects the next element the chart shows, alone, among IChart.getElements: what pressing an arrow key does with a chart selected.
Optionalreverse: boolean
Selects the previous one instead.
Removes items from the selection. Items not selected are ignored.
The elements of a chart that are selected: its title, an axis, a series, a point of one, a legend entry… (see IChart.IElement), as Excel selects them with a click inside a chart.
Remarks
A sheet's view holds one beside its movable selection (IWorksheetView.getChartElementSelection). Its elements are always of the one chart whose movable is the active selected movable: selecting an element of another chart selects that chart's movable first, alone, and the selection empties when the movable selection moves on. A chart outside a workbook (
createChart) takes a selection of its own, made with its chart.Every selected element has the same container; the chart area is the root and is never selected here: with nothing selected, the chart itself is what the movable selection holds.
Which element a press selects is the editor's: Excel selects a series on the first press and its point on the next (IChart.getElementAt answers the point).