Provides run-time access to AdapTable Column related features

TypeScript
export interface

Methods

MethodDescription
addColumnsToSelection(columnIds)Adds (highlights) a group of Columns to any existing selection
addColumnToSelection(columnId)Adds (highlights) a Column to any existing selection
autosizeAllColumns()Autosizes all Columns in the Grid
autosizeColumn(columnId)AutoSizes a Column
autosizeColumns(columnIds)Autosizes given Columns
doesColumnExist(columnId)Checks if Column has already been created
getAggregatableColumns()Returns all Aggregatable Columns
getAGGridColDefForColumnId(columnId)Returns AG Grid ColDef for a given ColumnId
getAGGridColumnForColumnId(columnId)Returns the AG Grid Column for a given ColumnId
getArrayColumns()Returns all array columns (number, tuple-number, object-number & text)
getBooleanColumns()Returns all boolean Columns
getColumnDataTypeForColumnId(columnId)Returns Data Type for the Column with given ColumnId
getColumnIdForFriendlyName(friendlyName)Retrieves ColumnId for Column with given Friendly Name
getColumnIdsForFriendlyNames(friendlyNames)Retrieves ColumnIds for Columns with given Friendly Names
getColumns()Returns all Columns available (including hidden, special)
getColumnsByColumnType(columnType)Returns all columns of a given columnType
getColumnSummaryForColumnId(columnId)Gets summary info for a column including filters and unique values
getColumnsWithColumnIds(columnIds)Retrieves Adaptable Columns with given ColumnIds
getColumnsWithDataType(dataType)Returns all Columns that have given DataType
getColumnsWithFriendlyNames(friendlyNames)Retrieves Adaptable Columns with given Friendly names
getColumnTypes()Returns available columns types defined under columnOptions.columnTypes
getColumnWithColumnId(columnId, logWarning)Retrieves AdapTable Column with given ColumnId
getColumnWithFriendlyName(columnName, logWarning)Retrieves AdapTable Column with given Friendly name
getDateColumns()Returns all Date Columns
getDefaultAggFunc(columnId)Returns the default Aggregation Function for a Column
getExportableColumns()Returns all Exportable Columns
getFilterableColumns()Returns all Sortable Columns
getFriendlyNameForColumnId(columnId, layout)Retrieves Friendly Name of Column with given ColumnId
getFriendlyNamesForColumnIds(columnIds)Retrieves Friendly Names for given ColumnIds
getGroupableColumns()Returns all Groupable Columns
getNonSpecialColumns()Returns all UI available columns excluding Action, FreeText and Calculated Columns
getNumberArrayColumns()Returns all number-array columns
getNumericArrayColumns()Returns all numeric array columns (number, tuple-number, object-number)
getNumericColumns()Returns all numeric Columns
getObjectNumberArrayColumns()Returns all object-number-array columns e.g. [x:1,y:2,x:3,y:4]
getPivotableColumns()Returns all Pivotable Columns
getPrimaryKeyColumn()Retrieves current Primary Key Column in AdapTable. It may be undefined if the primary key is auto-generated, or it is NOT mapped to a column.
getQueryableColumns()Returns all Queryable Columns
getRowGroupedColumns()Returns all columns currently Row Grouped
getSortableColumns()Returns all Sortable Columns
getSpecialColumns()Returns any Action, FreeText and Calculated Columns
getTextArrayColumns()Returns all string array Columns
getTextColumns()Returns all Text Columns
getTupleNumberArrayColumns()Returns all tuple-number-array columns e.g. [[1,2],[3,4]]
getUIAvailableColumns()Returns all Columns that can be displayed in UI (excludes always hidden cols)
getUIHiddenColumns()Returns Columns that are always hidden in UI (but available for Expressions)
getVisibleColumns()Returns all visible Columns
hasArrayDataType(columnId)Checks if the Column with the given columnId has any Array-like DataType (TextArray,NumberArray,TupleNumberArray or ObjectNumberArray)
hasBooleanDataType(columnId)Checks if the Column with the given columnId has DataType Boolean
hasColumnType(columnIdentifier, columnType)Checks if the Column with given Column Identifier (columnId or ColDef) has a specific Column Type
hasDateDataType(columnId)Checks if the Column with the given columnId has DataType Date
hasNumberDataType(columnId)Checks if the Column with the given columnId has DataType Number
hasNumericArrayDataType(columnId)Checks if the Column with the given columnId has an Numeric Array-like DataType (NumberArray,TupleNumberArray or ObjectNumberArray)
hasTextArrayDataType(columnId)Checks if the Column with the given columnId has a Text Array-like DataType (TextArray)
hideColumn(columnId)Hides a Column from Grid
isActionColumn(columnId)Checks if Column with given ColumnId is an Action Column
isAgGridGeneratedColumn(columnId)Whether column is auto generated by AG Grid (for selection, grouping, pivoting etc)
isAutoRowGroupColumn(columnId)Checks if Column with given ColumnId is a row-group Column automatically generated by AG Grid
isAutoRowGroupColumnForMulti(columnId)Checks if Column with given ColumnId is a row-group Column automatically generated by AG Grid, for row-grouping with group display type = 'multi'
isAutoRowGroupColumnForSingle(columnId)Checks if Column with given ColumnId is a row-group Column automatically generated by AG Grid, for row-grouping with group display type = 'single'
isCalculatedColumn(columnId)Checks if Column with given ColumnId is a Calculated Column
isColumnInGrid(columnId)Returns true if the given Column exists in the Grid
isFdc3Column(columnId)Checks if Column with given ColumnId is a FDC3 Column
isFreeTextColumn(columnId)Checks if Column with given ColumnId is a Free Text Column
isPivotAggColumnWithNoPivotColumns(columnId)Checks if Column with given ColumnId is a pivot aggregation column in a pivot layout with no pivot columns. When PivotColumns is empty, aggregation columns keep their original IDs instead of getting a 'pivot_' prefix.
isPivotResultColumn(columnId)Checks if Column with given ColumnId is a pivot Column automatically generated by AG Grid
isSelectionColumn(columnId)Checks if Column with given ColumnId is a Selection (Checkbox) Column automatically generated by AG Grid
isSpecialColumn(columnId)Checks if Column with given ColumnId is a Special (i.e. calculated, freetext or action) Column
openColumnInfoSettingsPanel()Opens Settings Panel with Column Info section selected and visible
selectAllColumns()Selects all Columns
selectColumn(columnId)Selects (highlights) a Column
selectColumns(columnIds)Selects (highlights) group of Columns
setColumnCaption(columnId, caption)Sets a new Caption / Header for a Column (only for current Layout)
showColumn(columnId)Makes a Column visible

Method Details

addColumnsToSelection

Adds (highlights) a group of Columns to any existing selection

TypeScript
addColumnsToSelection(columnIds: string[]): void;
Parameters
ParameterTypeDescription
columnIdsstring[]columns to select
Returns

void

addColumnToSelection

Adds (highlights) a Column to any existing selection

TypeScript
addColumnToSelection(columnId: string): void;
Parameters
ParameterTypeDescription
columnIdstringColumn to select
Returns

void

autosizeAllColumns

Autosizes all Columns in the Grid

TypeScript
autosizeAllColumns(): void;
Returns

void

autosizeColumn

AutoSizes a Column

TypeScript
autosizeColumn(columnId: string): void;
Parameters
ParameterTypeDescription
columnIdstringColumn to autosize
Returns

void

autosizeColumns

Autosizes given Columns

TypeScript
autosizeColumns(columnIds: string[]): void;
Parameters
ParameterTypeDescription
columnIdsstring[]Columns to autosize
Returns

void

doesColumnExist

Checks if Column has already been created

TypeScript
doesColumnExist(columnId: string): boolean;
Parameters
ParameterTypeDescription
columnIdstringColumnId to check
Returns

boolean

getAggregatableColumns

Returns all Aggregatable Columns

TypeScript
getAggregatableColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getAGGridColDefForColumnId

Returns AG Grid ColDef for a given ColumnId

TypeScript
getAGGridColDefForColumnId(columnId: string): ColDef | ColGroupDef;
Parameters
ParameterTypeDescription
columnIdstringColumn to use
Returns

ColDef | ColGroupDef

getAGGridColumnForColumnId

Returns the AG Grid Column for a given ColumnId

TypeScript
getAGGridColumnForColumnId(columnId: string): Column;
Parameters
ParameterTypeDescription
columnIdstringColumn to use
Returns

Column

getArrayColumns

Returns all array columns (number, tuple-number, object-number & text)

TypeScript
getArrayColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getBooleanColumns

Returns all boolean Columns

TypeScript
getBooleanColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getColumnDataTypeForColumnId

Returns Data Type for the Column with given ColumnId

TypeScript
getColumnDataTypeForColumnId(columnId: string): AdaptableColumnDataType | undefined;
Parameters
ParameterTypeDescription
columnIdstringColumn to check
Returns

AdaptableColumnDataType | undefined

getColumnIdForFriendlyName

Retrieves ColumnId for Column with given Friendly Name

TypeScript
getColumnIdForFriendlyName(friendlyName: string): string;
Parameters
ParameterTypeDescription
friendlyNamestringFriendly Name to Lookup
Returns

string

getColumnIdsForFriendlyNames

Retrieves ColumnIds for Columns with given Friendly Names

TypeScript
getColumnIdsForFriendlyNames(friendlyNames: string[]): string[];
Parameters
ParameterType
friendlyNamesstring[]
Returns

string[]

getColumns

Returns all Columns available (including hidden, special)

TypeScript
getColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getColumnsByColumnType

Returns all columns of a given columnType

TypeScript
getColumnsByColumnType(columnType: string): AdaptableColumn[];
Parameters
ParameterTypeDescription
columnTypestringthe columnType to filter by
Returns

AdaptableColumn[]

getColumnSummaryForColumnId

Gets summary info for a column including filters and unique values

TypeScript
getColumnSummaryForColumnId(columnId: string): AdaptableColumnSummary;
Parameters
ParameterTypeDescription
columnIdstringColumn to summarise
Returns

AdaptableColumnSummary

getColumnsWithColumnIds

Retrieves Adaptable Columns with given ColumnIds

TypeScript
getColumnsWithColumnIds(columnIds: string[]): AdaptableColumn[];
Parameters
ParameterTypeDescription
columnIdsstring[]Column Ids to lookup
Returns

AdaptableColumn[]

getColumnsWithDataType

Returns all Columns that have given DataType

TypeScript
getColumnsWithDataType(dataType: AdaptableColumnDataType): AdaptableColumn[];
Parameters
ParameterTypeDescription
dataTypeAdaptableColumnDataTypethe DataType of the Columns to retrieve
Returns

AdaptableColumn[]

getColumnsWithFriendlyNames

Retrieves Adaptable Columns with given Friendly names

TypeScript
getColumnsWithFriendlyNames(friendlyNames: string[]): AdaptableColumn[];
Parameters
ParameterTypeDescription
friendlyNamesstring[]Friendly Names to lookup
Returns

AdaptableColumn[]

getColumnTypes

Returns available columns types defined under columnOptions.columnTypes

TypeScript
getColumnTypes(): string[];
Returns

string[]

getColumnWithColumnId

Retrieves AdapTable Column with given ColumnId

TypeScript
getColumnWithColumnId(columnId: string, logWarning?: boolean): AdaptableColumn | undefined;
Parameters
ParameterTypeDescription
columnIdstringColumnId to lookup
logWarningbooleanWhether to log warning if Column missing
Returns

AdaptableColumn | undefined

getColumnWithFriendlyName

Retrieves AdapTable Column with given Friendly name

TypeScript
getColumnWithFriendlyName(columnName: string, logWarning?: boolean): AdaptableColumn;
Parameters
ParameterTypeDescription
columnNamestringFriendly Name to lookup
logWarningbooleanWhether to log warning if Column missing
Returns

AdaptableColumn

getDateColumns

Returns all Date Columns

TypeScript
getDateColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getDefaultAggFunc

Returns the default Aggregation Function for a Column

TypeScript
getDefaultAggFunc(columnId: string): string;
Parameters
ParameterTypeDescription
columnIdstringColumn to Check
Returns

string

getExportableColumns

Returns all Exportable Columns

TypeScript
getExportableColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getFilterableColumns

Returns all Sortable Columns

TypeScript
getFilterableColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getFriendlyNameForColumnId

Retrieves Friendly Name of Column with given ColumnId

TypeScript
getFriendlyNameForColumnId(columnId: string, layout?: Layout): string;
Parameters
ParameterTypeDescription
columnIdstringColumnId to lookup
layoutLayout
Returns

string

getFriendlyNamesForColumnIds

Retrieves Friendly Names for given ColumnIds

TypeScript
getFriendlyNamesForColumnIds(columnIds: string[]): string[];
Parameters
ParameterTypeDescription
columnIdsstring[]ColumnIds to lookup
Returns

string[]

getGroupableColumns

Returns all Groupable Columns

TypeScript
getGroupableColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getNonSpecialColumns

Returns all UI available columns excluding Action, FreeText and Calculated Columns

TypeScript
getNonSpecialColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getNumberArrayColumns

Returns all number-array columns

TypeScript
getNumberArrayColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getNumericArrayColumns

Returns all numeric array columns (number, tuple-number, object-number)

TypeScript
getNumericArrayColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getNumericColumns

Returns all numeric Columns

TypeScript
getNumericColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getObjectNumberArrayColumns

Returns all object-number-array columns e.g. [x:1,y:2,x:3,y:4]

TypeScript
getObjectNumberArrayColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getPivotableColumns

Returns all Pivotable Columns

TypeScript
getPivotableColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getPrimaryKeyColumn

Retrieves current Primary Key Column in AdapTable. It may be undefined if the primary key is auto-generated, or it is NOT mapped to a column.

TypeScript
getPrimaryKeyColumn(): AdaptableColumn | undefined;
Returns

AdaptableColumn | undefined

getQueryableColumns

Returns all Queryable Columns

TypeScript
getQueryableColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getRowGroupedColumns

Returns all columns currently Row Grouped

TypeScript
getRowGroupedColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getSortableColumns

Returns all Sortable Columns

TypeScript
getSortableColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getSpecialColumns

Returns any Action, FreeText and Calculated Columns

TypeScript
getSpecialColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getTextArrayColumns

Returns all string array Columns

TypeScript
getTextArrayColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getTextColumns

Returns all Text Columns

TypeScript
getTextColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getTupleNumberArrayColumns

Returns all tuple-number-array columns e.g. [[1,2],[3,4]]

TypeScript
getTupleNumberArrayColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getUIAvailableColumns

Returns all Columns that can be displayed in UI (excludes always hidden cols)

TypeScript
getUIAvailableColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getUIHiddenColumns

Returns Columns that are always hidden in UI (but available for Expressions)

TypeScript
getUIHiddenColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

getVisibleColumns

Returns all visible Columns

TypeScript
getVisibleColumns(): AdaptableColumn[];
Returns

AdaptableColumn[]

hasArrayDataType

Checks if the Column with the given columnId has any Array-like DataType (TextArray,NumberArray,TupleNumberArray or ObjectNumberArray)

TypeScript
hasArrayDataType(columnId: string): boolean;
Parameters
ParameterTypeDescription
columnIdstringColumn ID
Returns

boolean

hasBooleanDataType

Checks if the Column with the given columnId has DataType Boolean

TypeScript
hasBooleanDataType(columnId: string): boolean;
Parameters
ParameterTypeDescription
columnIdstringColumn ID
Returns

boolean

hasColumnType

Checks if the Column with given Column Identifier (columnId or ColDef) has a specific Column Type

TypeScript
hasColumnType(columnIdentifier: string | ColDef, columnType: string): boolean;
Parameters
ParameterTypeDescription
columnIdentifierstring | ColDefColumnId or ColDef to check
columnTypestringColumn Type to check for
Returns

boolean

hasDateDataType

Checks if the Column with the given columnId has DataType Date

TypeScript
hasDateDataType(columnId: string): boolean;
Parameters
ParameterTypeDescription
columnIdstringColumn ID
Returns

boolean

hasNumberDataType

Checks if the Column with the given columnId has DataType Number

TypeScript
hasNumberDataType(columnId: string): boolean;
Parameters
ParameterTypeDescription
columnIdstringColumn ID
Returns

boolean

hasNumericArrayDataType

Checks if the Column with the given columnId has an Numeric Array-like DataType (NumberArray,TupleNumberArray or ObjectNumberArray)

TypeScript
hasNumericArrayDataType(columnId: string): boolean;
Parameters
ParameterTypeDescription
columnIdstringColumn ID
Returns

boolean

hasTextArrayDataType

Checks if the Column with the given columnId has a Text Array-like DataType (TextArray)

TypeScript
hasTextArrayDataType(columnId: string): boolean;
Parameters
ParameterTypeDescription
columnIdstringColumn ID
Returns

boolean

hideColumn

Hides a Column from Grid

TypeScript
hideColumn(columnId: string): void;
Parameters
ParameterTypeDescription
columnIdstringColumn to hide
Returns

void

isActionColumn

Checks if Column with given ColumnId is an Action Column

TypeScript
isActionColumn(columnId: string): boolean;
Parameters
ParameterTypeDescription
columnIdstringColumnId to check
Returns

boolean

isAgGridGeneratedColumn

Whether column is auto generated by AG Grid (for selection, grouping, pivoting etc)

TypeScript
isAgGridGeneratedColumn(columnId: string): boolean;
Parameters
ParameterTypeDescription
columnIdstringcolumn to check
Returns

boolean

isAutoRowGroupColumn

Checks if Column with given ColumnId is a row-group Column automatically generated by AG Grid

TypeScript
isAutoRowGroupColumn(columnId: string): boolean;
Parameters
ParameterTypeDescription
columnIdstringColumnId to check
Returns

boolean

isAutoRowGroupColumnForMulti

Checks if Column with given ColumnId is a row-group Column automatically generated by AG Grid, for row-grouping with group display type = 'multi'

TypeScript
isAutoRowGroupColumnForMulti(columnId: string): boolean;
Parameters
ParameterTypeDescription
columnIdstringColumnId to check
Returns

boolean

isAutoRowGroupColumnForSingle

Checks if Column with given ColumnId is a row-group Column automatically generated by AG Grid, for row-grouping with group display type = 'single'

TypeScript
isAutoRowGroupColumnForSingle(columnId: string): boolean;
Parameters
ParameterTypeDescription
columnIdstringColumnId to check
Returns

boolean

isCalculatedColumn

Checks if Column with given ColumnId is a Calculated Column

TypeScript
isCalculatedColumn(columnId: string): boolean;
Parameters
ParameterTypeDescription
columnIdstringColumnId to check
Returns

boolean

isColumnInGrid

Returns true if the given Column exists in the Grid

TypeScript
isColumnInGrid(columnId: string): boolean;
Parameters
ParameterTypeDescription
columnIdstringColumn to check
Returns

boolean

isFdc3Column

Checks if Column with given ColumnId is a FDC3 Column

TypeScript
isFdc3Column(columnId: string): boolean;
Parameters
ParameterTypeDescription
columnIdstring
Returns

boolean

isFreeTextColumn

Checks if Column with given ColumnId is a Free Text Column

TypeScript
isFreeTextColumn(columnId: string): boolean;
Parameters
ParameterTypeDescription
columnIdstringColumnId to check
Returns

boolean

isPivotAggColumnWithNoPivotColumns

Checks if Column with given ColumnId is a pivot aggregation column in a pivot layout with no pivot columns. When PivotColumns is empty, aggregation columns keep their original IDs instead of getting a 'pivot_' prefix.

TypeScript
isPivotAggColumnWithNoPivotColumns(columnId: string): boolean;
Parameters
ParameterTypeDescription
columnIdstringColumnId to check
Returns

boolean

isPivotResultColumn

Checks if Column with given ColumnId is a pivot Column automatically generated by AG Grid

TypeScript
isPivotResultColumn(columnId: string): boolean;
Parameters
ParameterTypeDescription
columnIdstringColumnId to check
Returns

boolean

isSelectionColumn

Checks if Column with given ColumnId is a Selection (Checkbox) Column automatically generated by AG Grid

TypeScript
isSelectionColumn(columnId: string): boolean;
Parameters
ParameterTypeDescription
columnIdstringColumnId to check
Returns

boolean

isSpecialColumn

Checks if Column with given ColumnId is a Special (i.e. calculated, freetext or action) Column

TypeScript
isSpecialColumn(columnId: string): boolean;
Parameters
ParameterTypeDescription
columnIdstringColumnId to check
Returns

boolean

openColumnInfoSettingsPanel

Opens Settings Panel with Column Info section selected and visible

TypeScript
openColumnInfoSettingsPanel(): void;
Returns

void

selectAllColumns

Selects all Columns

TypeScript
selectAllColumns(): void;
Returns

void

selectColumn

Selects (highlights) a Column

TypeScript
selectColumn(columnId: string): void;
Parameters
ParameterTypeDescription
columnIdstringColumn to select
Returns

void

selectColumns

Selects (highlights) group of Columns

TypeScript
selectColumns(columnIds: string[]): void;
Parameters
ParameterTypeDescription
columnIdsstring[]columns to select
Returns

void

setColumnCaption

Sets a new Caption / Header for a Column (only for current Layout)

TypeScript
setColumnCaption(columnId: string, caption: string): void;
Parameters
ParameterTypeDescription
columnIdstringColumn to Update
captionstringNew Caption to display
Returns

void

showColumn

Makes a Column visible

TypeScript
showColumn(columnId: string): void;
Parameters
ParameterTypeDescription
columnIdstringColumn to show
Returns

void