API REFERENCE
setCanonicalRanges
Changes cell selection from normalized range input and returns the change result.
What does this API do?
Changes cell selection from normalized range input and returns the change result.
API for Pro features: Cell range selection
Exact input and result types
setCanonicalRanges(ranges: SyGridCellRangeInput[]): Promise<SyGridCanonicalChange[]>| Arguments | Required | Type |
|---|---|---|
| ranges | Required | SyGridCellRangeInput[] |
The return type is Promise<SyGridCanonicalChange[]>.
Usage flow
After registering and initializing the Grid element, call grid.setCanonicalRanges(…). Read the return value with await. For methods returning a boolean or report, inspect the result before continuing.
Read related types
Feature explanations and examples
- Cell range selection
A cell range is a rectangle spanning rows and columns. It defines the scope for copying, pasting, filling, and chart creation; selecting it does not change values.