JSDoc: Class: JSON

new JSON()

Same parameters as initialize, which is called by this constructor.

Extends

Behavior

Members

applyAnalytics

Synonym of Behavior#reindex.

Inherited From:

Behavior#applyAnalytics

Deprecated:

columnEnumKey

Style enum keys.

Override this method to style your keys to your liking.

See:

{@columnEnumDecorators} or roll your own

subgrids :Array.<dataModelAPI>

An array where each element represents a subgrid to be rendered in the hypergrid.

The list should always include at least one "data" subgrid, typically dataModel. It may also include zero or more other types of subgrids such as header, filter, and summary subgrids.

This object also sports a dictionary of subgrids in lookup property where each dictionary key is one of:

subgrid.name (for those that have a defined name, which is presumed to be unique)
subgrid.type (not unique, so if you plan on having multiple, name them!)
'data' for the (one and only) data subgrid when unnamed (note that data subgrids have no type)

The setter:

"Enlivens" any constructors (see createSubgrid for details).
Reconstructs the dictionary.
Calls shapeChanged().

Type:

Array.<dataModelAPI>

Inherited From:

Behavior#subgrids

Methods

_fixedColumnClicked(grid, mouse)

The fixed column area has been clicked, massage the details and call the real function.

Parameters:

Name	Type	Description
`grid`	Hypergrid
`mouse`	Object	event details

Inherited From:

Behavior#_fixedColumnClicked

_fixedRowClicked(grid, mouse)

The fixed row area has been clicked, massage the details and call the real function.

Parameters:

Name	Type	Description
`grid`	Hypergrid
`mouse`	Object	event details

Inherited From:

Behavior#_fixedRowClicked

_setScrollPositionX(x)

Set the scroll position in horizontal dimension and notify listeners.

Parameters:

Name	Type	Description
`x`	number	the new x value

Inherited From:

Behavior#_setScrollPositionX

_setScrollPositionY(y)

Set the scroll position in vertical dimension and notify listeners.

Parameters:

Name	Type	Description
`y`	number	the new y value

Inherited From:

Behavior#_setScrollPositionY

addCellProperties(xOrCellEvent, yopt, properties, dataModelopt)

update the data at point x, y with value

Parameters:

Name	Type	Attributes	Default	Description
`xOrCellEvent`	CellEvent \| number			Data x coordinate.
`y`	number	<optional>		Grid row coordinate. Omit when `xOrCellEvent` is a `CellEvent`.
`properties`	Object			Hash of cell properties. When `y` omitted, this param promoted to 2nd arg.
`dataModel`	dataModelAPI	<optional>	this.subgrids.lookup.data	For use only when `xOrCellEvent` is not a `CellEvent`: Provide a subgrid.

Inherited From:

Behavior#addCellProperties

addRowProperties(yOrCellEvent, properties, dataModelopt)

Add all the properties in the given row properties object to the row properties.

Parameters:

Name	Type	Attributes	Default	Description
`yOrCellEvent`	number \| CellEvent			Data row index local to `dataModel`; or a `CellEvent` object.
`properties`	object \| undefined			An object containing new property values(s) to assign to the row properties. If `undefined`, this call is a no-op.
`dataModel`	dataModelAPI	<optional>	this.dataModel	This is the subgrid. You only need to provide the subgrid when it is not the data subgrid and you did not give a `CellEvent` object in the first param (which already knows what subgrid it's in).

Inherited From:

Behavior#addRowProperties

cellClicked(event) → {boolean}

A specific cell was clicked; you've been notified.

Parameters:

Name	Type	Description
`event`	Object	all event information

Inherited From:

Behavior#cellClicked

Returns:

Clicked in a drill-down column.

Type: boolean

cellDoubleClicked(cell, event)

A specific cell was le double-clicked; you've been notified.

Parameters:

Name	Type	Description
`cell`	Point	point of cell coordinates
`event`	Object	all event information

Inherited From:

Behavior#cellDoubleClicked

cellFixedColumnPrePaintNotification(cell)

this function is a hook and is called just before the painting of a fixed column cell occurs

Parameters:

Name	Type	Description
`cell`	window.fin.rectangular.Point

Inherited From:

Behavior#cellFixedColumnPrePaintNotification

cellFixedRowPrePaintNotification(cell)

this function is a hook and is called just before the painting of a fixed row cell occurs

Parameters:

Name	Type	Description
`cell`	window.fin.rectangular.Point

Inherited From:

Behavior#cellFixedRowPrePaintNotification

cellPropertiesPrePaintNotification(cell)

this function is a hook and is called just before the painting of a cell occurs

Parameters:

Name	Type	Description
`cell`	window.fin.rectangular.Point

Inherited From:

Behavior#cellPropertiesPrePaintNotification

cellTopLeftPrePaintNotification(cell)

this function is a hook and is called just before the painting of a top left cell occurs

Parameters:

Name	Type	Description
`cell`	window.fin.rectangular.Point

Inherited From:

Behavior#cellTopLeftPrePaintNotification

changed()

I've been notified that the behavior has changed.

Inherited From:

Behavior#changed

clearAllCellProperties(xopt)

Clears all cell properties of given column or of all columns.

Parameters:

Name	Type	Attributes	Description
`x`	number	<optional>	Omit for all columns.

Overrides:

Behavior#clearAllCellProperties

clearObjectProperties(obj, exportPropsopt)

utility function to empty an object of its members

Parameters:

Name	Type	Attributes	Description
`obj`	object		the object to empty
`exportProps`	boolean	<optional>	`undefined` (omitted) - delete all properties falsy - delete only the export properties truthy - delete all properties except the export properties

Inherited From:

Behavior#clearObjectProperties

clearState()

clear all table state

Inherited From:

Behavior#clearState

createSubgrid(spec) → {dataModelAPI}

Maps a subgridSpec to a data model.

The spec may describe either an existing data model, or a constructor for a new data model.

Parameters:

Name	Type	Description
`spec`	subgridSpec

Inherited From:

Behavior#createSubgrid

Returns:

A data model.

Type: dataModelAPI

endDragColumnNotification()

a dnd column has just been dropped, we've been notified

Inherited From:

Behavior#endDragColumnNotification

getActiveColumnCount() → {number}

Number of visible columns.

Inherited From:

Behavior#getActiveColumnCount

Returns:

The total number of columns.

Type: number

getCellEditorAt(editPoint) → {cellEditor}

Parameters:

Name	Type	Description
`editPoint`	CellEvent	The grid cell coordinates.

Inherited From:

Behavior#getCellEditorAt

Returns:

The cell editor for the cell at the given coordinates.

Type: cellEditor

getCellOwnProperties(xOrCellEvent, yopt, dataModelopt) → {undefined|object}

Get the cell's own properties object.

May be undefined because cells only have their own properties object when at lest one own property has been set.

Parameters:

Name	Type	Attributes	Default	Description
`xOrCellEvent`	CellEvent \| number			Data x coordinate.
`y`	number	<optional>		Grid row coordinate. Omit when `xOrCellEvent` is a `CellEvent`.
`dataModel`	dataModelAPI	<optional>	this.subgrids.lookup.data	For use only when `xOrCellEvent` is not a `CellEvent`: Provide a subgrid.

Inherited From:

Behavior#getCellOwnProperties

Returns:

The "own" properties of the cell at x,y in the grid. If the cell does not own a properties object, returns undefined.

Type: undefined | object

getCellProperties(xOrCellEvent, yopt, dataModelopt) → {object}

Get the properties object for cell.

This is the cell's own properties object if found else the column object.

If you are seeking a single specific property, consider calling Behavior#getCellProperty instead.

Parameters:

Name	Type	Attributes	Default	Description
`xOrCellEvent`	CellEvent \| number			Data x coordinate.
`y`	number	<optional>		Grid row coordinate. Omit when `xOrCellEvent` is a `CellEvent`.
`dataModel`	dataModelAPI	<optional>	this.subgrids.lookup.data	For use only when `xOrCellEvent` is not a `CellEvent`: Provide a subgrid.

Inherited From:

Behavior#getCellProperties

Returns:

The properties of the cell at x,y in the grid.

Type: object

getCellProperty(xOrCellEvent, yopt, key, dataModelopt) → {object}

Return a specific cell property.

If there is no cell properties object, defers to column properties object.

Parameters:

Name	Type	Attributes	Default	Description
`xOrCellEvent`	CellEvent \| number			Data x coordinate.
`y`	number	<optional>		Grid row coordinate. Omit when `xOrCellEvent` is a `CellEvent`.
`key`	string			Name of property to get. When `y` omitted, this param promoted to 2nd arg.
`dataModel`	dataModelAPI	<optional>	this.subgrids.lookup.data	For use only when `xOrCellEvent` is not a `CellEvent`: Provide a subgrid.

Inherited From:

Behavior#getCellProperty

Returns:

The specified property for the cell at x,y in the grid.

Type: object

getColumnProperties(x) → {Object}

Parameters:

Name	Type	Description
`x`	index	Data x coordinate.

Inherited From:

Behavior#getColumnProperties

Returns:

The properties for a specific column.

Type: Object

getController(type) → {undefined|*}

Get the given data controller.

Parameters:

Name	Type	Description
`type`	string

Inherited From:

Behavior#getController

Returns:

The data controller; or undefined if data controller unknown to data model.

Type: undefined | *

getCursorAt(x, y) → {null}

Parameters:

Name	Type	Description
`x`	number	the x coordinate
`y`	number	the y coordinate

Inherited From:

Behavior#getCursorAt

Returns:

the cursor at a specific x,y coordinate

Type: null

getDefaultRowHeight() → {number}

The value is lazily initialized and comes from the properties mechanism for 'defaultRowHeight', which should be ~20px.

Inherited From:

Behavior#getDefaultRowHeight

Returns:

The row height in pixels.

Type: number

getFixedColumnCount() → {number}

Inherited From:

Behavior#getFixedColumnCount

Returns:

The number of fixed columns.

Type: number

getFixedColumnsMaxWidth() → {number}

This exists to support "floating" columns.

Inherited From:

Behavior#getFixedColumnsMaxWidth

Returns:

The total width of the fixed columns area.

Type: number

getFixedColumnsWidth() → {number}

Inherited From:

Behavior#getFixedColumnsWidth

Returns:

The width of the fixed column area in the hypergrid.

Type: number

getFixedRowCount() → {number}

The number of "fixed rows."

The number of (non-scrollable) rows preceding the (scrollable) data subgrid.

Inherited From:

Behavior#getFixedRowCount

Returns:

The sum of:

All rows of all subgrids preceding the data subgrid.
The first fixedRowCount rows of the data subgrid.

Type: number

getFixedRowsHeight() → {number}

The total height of the "fixed rows."

The total height of all (non-scrollable) rows preceding the (scrollable) data subgrid.

Inherited From:

Behavior#getFixedRowsHeight

Returns:

The height in pixels of the fixed rows area of the hypergrid, the total height of:

All rows of all subgrids preceding the data subgrid.
The first fixedRowCount rows of the data subgrid.

Type: number

getFooterRowCount()

Gets the number of "footer rows".

Defined as the sum of all rows in all subgrids after the (last) data subgrid.

getHeaderRowCount()

Gets the number of "header rows".

Defined as the sum of all rows in all subgrids before the (first) data subgrid.

getHiddenColumnDescriptors() → {Array.<string>}

Inherited From:

Behavior#getHiddenColumnDescriptors

Returns:

All the currently hidden column header labels.

Type: Array.<string>

getLogicalRowCount()

Gets the total number of logical rows.

Defined as the sum of all rows in all subgrids.

getPrivateState() → {object}

getter for a Memento Object

Inherited From:

Behavior#getPrivateState

Returns:

Type: object

getRow(y) → {object}

Parameters:

Name	Type	Description
`y`	number	the row index of interest

Inherited From:

Behavior#getRow

Returns:

The object at y index.

Type: object

getRowCount()

Gets the number of rows in the data subgrid.

Inherited From:

Behavior#getRowCount

getRowHeight(yOrCellEvent, dataModelopt) → {number}

Parameters:

Name	Type	Attributes	Default	Description
`yOrCellEvent`	number			Data row index local to `dataModel`.
`dataModel`	dataModelAPI	<optional>	this.dataModel

Inherited From:

Behavior#getRowHeight

Returns:

The row height in pixels.

Type: number

getRowProperties(yOrCellEvent, prototypeopt, dataModelopt) → {object|undefined}

Parameters:

Name	Type	Attributes	Default	Description
`yOrCellEvent`	number \| CellEvent			Data row index local to `dataModel`; or a `CellEvent` object.
`prototype`	boolean	<optional>		Prototype for a new properties object when one does not already exist. If you don't define this and one does not already exist, this call will return `undefined`. Typical defined value is `null`, which creates a plain object with no prototype, or `Object.prototype` for a more "natural" object. (Required when 3rd param provided.)
`dataModel`	dataModelAPI	<optional>	this.dataModel	This is the subgrid. You only need to provide the subgrid when it is not the data subgrid and you did not give a `CellEvent` object in the first param (which already knows what subgrid it's in).

Inherited From:

Behavior#getRowProperties

Returns:

The row properties object which will be one of:

object - existing row properties object or new row properties object created from prototype; else
false - row found but no existing row properties object and prototype was not defined; else
undefined - no such row

Type: object | undefined

getValue(xOrCellEvent, yopt, dataModelopt)

Parameters:

Name	Type	Attributes	Description
`xOrCellEvent`	CellEvent \| number		Grid column coordinate.
`y`	number	<optional>	Grid row coordinate. Omit if `xOrCellEvent` is a CellEvent.
`dataModel`	dataModelAPI	<optional>	For use only when `xOrCellEvent` is not a `CellEvent`: Provide a subgrid. If given, x and y are interpreted as data cell coordinates (unadjusted for scrolling). Does not default to the data subgrid, although you can provide it explicitly (`this.subgrids.lookup.data`).

Inherited From:

Behavior#getValue

handleMouseDown(grid, event)

delegate handling mouse down to the feature chain of responsibility

Parameters:

Name	Type	Description
`grid`	Hypergrid
`event`	Object	the event details

Inherited From:

Behavior#handleMouseDown

handleMouseExit(grid, event)

delegate handling mouse exit to the feature chain of responsibility

Parameters:

Name	Type	Description
`grid`	Hypergrid
`event`	Object	the event details

Inherited From:

Behavior#handleMouseExit

hideColumns(isActiveColumnIndexesopt, columnIndexes)

Hide active column(s).

Removes one or several columns from the "active" column list.

Parameters:

Name Type Attributes Default Description

Name	Type	Attributes	Default	Description
`isActiveColumnIndexes`	boolean	<optional>	false	Which list `columnIndexes` refers to: `true` - The active column list. `false` - The full column list (as per column schema array).
`columnIndexes`	number \| Array.<number>			Column index(es) into list as determined by `isActiveColumnIndexes`. One of: Scalar column index - Adds single column at insertion point. Array of column indexes - Adds multiple consecutive columns at insertion point. This required parameter is promoted left one arg position when `isActiveColumnIndexes` omitted.

isActiveColumnIndexes

boolean

false

Which list columnIndexes refers to:

true - The active column list.
false - The full column list (as per column schema array).

columnIndexes

number | Array.<number>

Column index(es) into list as determined by isActiveColumnIndexes. One of:

Scalar column index - Adds single column at insertion point.
Array of column indexes - Adds multiple consecutive columns at insertion point.

This required parameter is promoted left one arg position when isActiveColumnIndexes omitted.

Inherited From:

Behavior#hideColumns

highlightCellOnHover(isColumnHovered, isRowHovered) → {boolean}

Parameters:

Name	Type	Description
`isColumnHovered`	boolean	the column is hovered or not
`isRowHovered`	boolean	the row is hovered or not

Inherited From:

Behavior#highlightCellOnHover

Returns:

true if we should highlight on hover

Type: boolean

initialize()

Constructor logic, called afterBehavior.initialize().

This method will be called upon instantiation of this class or of any class that extends from this class.

All initialize() methods in the inheritance chain are called, in turn, each with the same parameters that were passed to the constructor, beginning with that of the most "senior" class through that of the class of the new instance.

Overrides:

Behavior#initialize

initializeFeatureChain(gridopt)

Create the feature chain - this is the chain of responsibility pattern.

Parameters:

Name	Type	Attributes	Description
`grid`	Hypergrid	<optional>	Unnecesary legacy parameter. May be omitted.

Inherited From:

Behavior#initializeFeatureChain

isColumnReorderable() → {boolean}

Inherited From:

Behavior#isColumnReorderable

Returns:

Can re-order columns.

Type: boolean

onClick(grid, event)

delegate handling tap to the feature chain of responsibility

Parameters:

Name	Type	Description
`grid`	Hypergrid
`event`	Object	the event details

Inherited From:

Behavior#onClick

onContextMenu(grid, event)

delegate handling tap to the feature chain of responsibility

Parameters:

Name	Type	Description
`grid`	Hypergrid
`event`	Object	the event details

Inherited From:

Behavior#onContextMenu

onDoubleClick(grid, event)

delegate handling double click to the feature chain of responsibility

Parameters:

Name	Type	Description
`grid`	Hypergrid
`event`	Object	the event details

Inherited From:

Behavior#onDoubleClick

onKeyDown(grid, event)

delegate handling key down to the feature chain of responsibility

Parameters:

Name	Type	Description
`grid`	Hypergrid
`event`	Object	the event details

Inherited From:

Behavior#onKeyDown

onKeyUp(grid, event)

delegate handling key up to the feature chain of responsibility

Parameters:

Name	Type	Description
`grid`	Hypergrid
`event`	Object	the event details

Inherited From:

Behavior#onKeyUp

onMouseDrag(grid, event)

delegate handling mouse drag to the feature chain of responsibility

Parameters:

Name	Type	Description
`grid`	Hypergrid
`event`	Object	the event details

Inherited From:

Behavior#onMouseDrag

onMouseMove(grid, event)

delegate handling mouse move to the feature chain of responsibility

Parameters:

Name	Type	Description
`grid`	Hypergrid
`event`	Object	the event details

Inherited From:

Behavior#onMouseMove

onMouseUp(grid, event)

delegate handling mouse up to the feature chain of responsibility

Parameters:

Name	Type	Description
`grid`	Hypergrid
`event`	Object	the event details

Inherited From:

Behavior#onMouseUp

onWheelMoved(grid, event)

delegate handling wheel moved to the feature chain of responsibility

Parameters:

Name	Type	Description
`grid`	Hypergrid
`event`	Object	the event details

Inherited From:

Behavior#onWheelMoved

reindex()

Overrides:

Behavior#reindex

reset(optionsopt)

Parameters:

Name Type Attributes Description

options

object

Properties

Name Type Attributes Description

pipeline

object

Consumed by dataModels.JSON#reset.

If omitted, previously established pipeline is reused.

controllers

object

Consumed by dataModels.JSON#reset.

If omitted, previously established controllers list is reused.

Inherited From:

Behavior#reset

resolveProperty(key) → {*}

fetch the value for a property key

Parameters:

Name	Type	Description
`key`	string	a property name

Inherited From:

Behavior#resolveProperty

Returns:

The value of the given property.

Type: *

setCellProperties(xOrCellEvent, yopt, properties, dataModelopt)

update the data at point x, y with value

Parameters:

Name	Type	Attributes	Default	Description
`xOrCellEvent`	CellEvent \| number			Data x coordinate.
`y`	number	<optional>		Grid row coordinate. Omit when `xOrCellEvent` is a `CellEvent`.
`properties`	Object			Hash of cell properties. When `y` omitted, this param promoted to 2nd arg.
`dataModel`	dataModelAPI	<optional>	this.subgrids.lookup.data	For use only when `xOrCellEvent` is not a `CellEvent`: Provide a subgrid.

Inherited From:

Behavior#setCellProperties

setCellProperty(xOrCellEvent, yopt, key, value, dataModelopt)

Set a specific cell property.

If there is no cell properties object, defers to column properties object.

NOTE: For performance reasons, renderer's cell event objects cache their respective cell properties objects. This method accepts a CellEvent overload. Whenever possible, use the CellEvent from the renderer's cell event pool. Doing so will reset the cell properties object cache.

If you use some other CellEvent, the renderer's CellEvent properties cache will not be automatically reset until the whole cell event pool is reset on the next call to Renderer#computeCellBoundaries. If necessary, you can "manually" reset it by calling resetCellPropertiesCache(yourCellEvent) which searches the cell event pool for one with matching coordinates and resets the cache.

The raw coordinates overload calls the resetCellPropertiesCache(x, y) overload for you.

Parameters:

Name	Type	Attributes	Default	Description
`xOrCellEvent`	CellEvent \| number			`CellEvent` or data x coordinate.
`y`	number	<optional>		Grid row coordinate. Omit when `xOrCellEvent` is a `CellEvent`.
`key`	string			Name of property to get. When `y` omitted, this param promoted to 2nd arg.
`value`
`dataModel`	dataModelAPI	<optional>	this.subgrids.lookup.data	For use only when `xOrCellEvent` is not a `CellEvent`: Provide a subgrid.

Inherited From:

Behavior#setCellProperty

setColumnIndexes(columnIndexes, silentopt)

Rebuild the column order indexes

Parameters:

Name	Type	Attributes	Default	Description
`columnIndexes`	Array			list of column indexes
`silent`	Boolean	<optional>	false	whether to trigger column changed event

Inherited From:

Behavior#setColumnIndexes

setColumnProperties(x) → {Object}

Parameters:

Name	Type	Description
`x`	index	Data x coordinate.

Inherited From:

Behavior#setColumnProperties

Returns:

The properties for a specific column.

Type: Object

setColumns(columnDefinitions)

Build the fields and headers from the supplied column definitions.

myJsonBehavior.setColumns([
    { header: 'Stock Name', name: 'short_description' },
    { header: 'Status', name: 'trading_phase' },
    { header: 'Reference Price', name: 'reference_price' }
]);

Parameters:

Name	Type	Description
`columnDefinitions`	Array	an array of objects with fields 'title', and 'field'

setController(typeOrHashOfTypes, controlleropt) → {object}

Set the given data controller(s).

Triggers a shape change.

Parameters:

Name Type Attributes Description

Name	Type	Attributes	Description
`typeOrHashOfTypes`	string		One of: object - Hash of multiple data controllers, by type. string - Type of the single data controller given in `controller`.
`controller`	dataControlInterface	<optional>	Only required when 'hash' is a string; omit when `hash` is an object.

typeOrHashOfTypes

string

One of:

object - Hash of multiple data controllers, by type.
string - Type of the single data controller given in controller.

controller

dataControlInterface

Only required when 'hash' is a string; omit when hash is an object.

Inherited From:

Behavior#setController

Returns:

Hash of all results, by type. Each member will be:
The given data controller for that type when defined.
A new "null" data controller, generated by the data model when the given data controller for that type was undefined.
undefined - The data controller was unknown to the data model..

Type: object

setCursor(grid)

delegate setting the cursor up the feature chain of responsibility

Parameters:

Name	Type	Description
`grid`	Hypergrid

Inherited From:

Behavior#setCursor

setData(dataRowsopt, optionsopt)

Set the data field.

Parameters:

Name	Type	Attributes	Default	Description
`dataRows`	function \| Array.<object>	<optional>	options.data	Array of uniform data row objects or function returning same.
`options`	object	<optional>		Takes first argument position when `dataRows` omitted.
`options.data`	function \| object	<optional>		Array of uniform data row objects or function returning same. Passed as 1st param to `dataModel.JSON#setData`. If falsy, method aborted.
`options.fields`	function \| object	<optional>		Array of field names or function returning same. Passed as 2nd param to `dataModel.JSON#setData`.
`options.calculators`	function \| object	<optional>		Array of calculators or function returning same. Passed as 3rd param to `dataModel.JSON#setData`.
`options.apply`	boolean	<optional>	true	Apply data transformations to the new data.

setFields(fieldNames)

Set the fields array.

Parameters:

Name	Type	Description
`fieldNames`	Array.<string>	The field names.

setFixedColumnCount(n)

set the number of fixed columns

Parameters:

Name	Type	Description
`n`	number	the integer count of how many columns to be fixed

Inherited From:

Behavior#setFixedColumnCount

setFixedRowCount(The) → {number}

Set the number of fixed rows, which includes (top to bottom order):

The header rows
1. The header labels row (optional)
2. The filter row (optional)
3. The top total rows (0 or more)
The non-scrolling rows (externally called "the fixed rows")

Parameters:

Name	Type	Description
`The`	number	number of rows.

Inherited From:

Behavior#setFixedRowCount

Returns:

Sum of the above or 0 if none of the above are in use.

Type: number

setHeaders(headers)

Set the header labels.

Parameters:

Name Type Description

headers

Array.<string> | object

The header labels. One of:

If an array: Must contain all headers in column order.
If a hash: May contain any headers, keyed by field name, in any order.

setPipeline(DataSourcesopt, optionsopt)

Parameters:

Name	Type	Attributes	Default	Description
`DataSources`	object	<optional>		New pipeline description. (See `dataModels.JSON#setPipeline`.)
`options`	object	<optional>		Takes first argument position when `DataSources` omitted. (See `dataModels.JSON#setPipeline`.)
`options.apply`	boolean	<optional>	true	Apply data transformations to the new data.

See:

dataModels.JSON#setPipeline

setRowHeight(yOrCellEvent, height, dataModelopt)

set the pixel height of a specific row

Parameters:

Name	Type	Attributes	Default	Description
`yOrCellEvent`	number			Data row index local to dataModel.
`height`	number			pixel height
`dataModel`	dataModelAPI	<optional>	this.dataModel

Inherited From:

Behavior#setRowHeight

setRowProperties(yOrCellEvent, properties, dataModelopt)

Reset the row properties in its entirety to the given row properties object.

Parameters:

Name	Type	Attributes	Default	Description
`yOrCellEvent`	number \| CellEvent			Data row index local to `dataModel`; or a `CellEvent` object.
`properties`	object \| undefined			The new row properties object. If `undefined`, this call is a no-op.
`dataModel`	dataModelAPI	<optional>	this.dataModel	This is the subgrid. You only need to provide the subgrid when it is not the data subgrid and you did not give a `CellEvent` object in the first param (which already knows what subgrid it's in).

Inherited From:

Behavior#setRowProperties

setRowProperty(yOrCellEvent, key, value, dataModelopt)

Sets a single row property on a specific individual row.

Parameters:

Name	Type	Attributes	Default	Description
`yOrCellEvent`	number \| CellEvent			Data row index local to `dataModel`; or a `CellEvent` object.
`key`	string			The property name.
`value`				The new property value.
`dataModel`	dataModelAPI	<optional>	this.dataModel	This is the subgrid. You only need to provide the subgrid when it is not the data subgrid and you did not give a `CellEvent` object in the first param (which already knows what subgrid it's in).

Inherited From:

Behavior#setRowProperty

setScrollPositionX(x)

Column alignment of given grid column.

Quietly set the horizontal scroll position.

Parameters:

Name	Type	Description
`x`	number	The new position in pixels.

Inherited From:

Behavior#setScrollPositionX

setScrollPositionY(y)

Quietly set the vertical scroll position.

Parameters:

Name	Type	Description
`y`	number	The new position in pixels.

Inherited From:

Behavior#setScrollPositionY

setState(properties)

Restore this table to a previous state. See the memento pattern.

Parameters:

Name	Type	Description
`properties`	Object	assignable grid properties

Inherited From:

Behavior#setState

setValue(xOrCellEvent, yopt, value, dataModelopt) → {boolean}

update the data at point x, y with value

Parameters:

Name	Type	Attributes	Description
`xOrCellEvent`	CellEvent \| number		Grid column coordinate.
`y`	number	<optional>	Grid row coordinate. Omit if `xOrCellEvent` is a CellEvent.
`value`	Object		The value to use. When `y` omitted, promoted to 2nd arg.
`dataModel`	dataModelAPI	<optional>	For use only when `xOrCellEvent` is not a `CellEvent`: Provide a subgrid. If given, x and y are interpreted as data cell coordinates (unadjusted for scrolling). Does not default to the data subgrid, although you can provide it explicitly (`this.subgrids.lookup.data`).

Inherited From:

Behavior#setValue

Returns:

The data.
Consumed.

Type

boolean

shapeChanged()

The dimensions of the grid data have changed. You've been notified.

Inherited From:

Behavior#shapeChanged

showColumns(isActiveColumnIndexesopt, columnIndexes, referenceIndexopt, allowDuplicateColumnsopt)

Show inactive column(s) or move active column(s).

Adds one or several columns to the "active" column list.

Parameters:

Name	Type	Attributes	Default	Description
`isActiveColumnIndexes`	boolean	<optional>	false	Which list `columnIndexes` refers to: `true` - The active column list. This can only move columns around within the active column list; it cannot add inactive columns (because it can only refer to columns in the active column list). `false` - The full column list (as per column schema array). This inserts columns from the "inactive" column list, moving columns that are already active.
`columnIndexes`	number \| Array.<number>			Column index(es) into list as determined by `isActiveColumnIndexes`. One of: Scalar column index - Adds single column at insertion point. Array of column indexes - Adds multiple consecutive columns at insertion point. This required parameter is promoted left one arg position when `isActiveColumnIndexes` omitted.
`referenceIndex`	number	<optional>	this.columns.length	Insertion point, i.e., the element to insert before. A negative values skips the reinsert. Default is to insert new columns at end of active column list. Promoted left one arg position when `isActiveColumnIndexes` omitted.
`allowDuplicateColumns`	boolean	<optional>	false	Unless true, already visible columns are removed first. Promoted left one arg position when `isActiveColumnIndexes` omitted + one position when `referenceIndex` omitted.

Inherited From:

Behavior#showColumns

stateChanged()

The dimensions of the grid data have changed. You've been notified.

Inherited From:

Behavior#stateChanged

swapColumns(src, tar)

swap src and tar columns

Parameters:

Name	Type	Description
`src`	number	column index
`tar`	number	column index

Inherited From:

Behavior#swapColumns

unstashPipeline(whichStashopt, optionsopt)

Pop pipeline stack.

Parameters:

Name	Type	Attributes	Default	Description
`whichStash`	string	<optional>
`options`	object	<optional>		Takes first argument position when `DataSources` omitted.
`options.apply`	boolean	<optional>	true	Apply data transformations to the new data.

See:

dataModels.JSON#unstashPipeline

updateData(dataRows, options)

Rebinds the data without reshaping it.

See setData's parameter descriptions.

Parameters:

Name	Type	Description
`dataRows`
`options`