ColumnApi
Provides run-time access to AdapTable Column related features
export interfaceMethods
| Method | Description |
|---|---|
| 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
addColumnsToSelection(columnIds: string[]): void;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnIds | string[] | columns to select |
Returns
void
addColumnToSelection
Adds (highlights) a Column to any existing selection
addColumnToSelection(columnId: string): void;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | Column to select |
Returns
void
autosizeAllColumns
Autosizes all Columns in the Grid
autosizeAllColumns(): void;Returns
void
autosizeColumn
AutoSizes a Column
autosizeColumn(columnId: string): void;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | Column to autosize |
Returns
void
autosizeColumns
Autosizes given Columns
autosizeColumns(columnIds: string[]): void;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnIds | string[] | Columns to autosize |
Returns
void
doesColumnExist
Checks if Column has already been created
doesColumnExist(columnId: string): boolean;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | ColumnId to check |
Returns
boolean
getAggregatableColumns
Returns all Aggregatable Columns
getAggregatableColumns(): AdaptableColumn[];Returns
getAGGridColDefForColumnId
Returns AG Grid ColDef for a given ColumnId
getAGGridColDefForColumnId(columnId: string): ColDef | ColGroupDef;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | Column to use |
Returns
ColDef | ColGroupDef
getAGGridColumnForColumnId
Returns the AG Grid Column for a given ColumnId
getAGGridColumnForColumnId(columnId: string): Column;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | Column to use |
Returns
Column
getArrayColumns
Returns all array columns (number, tuple-number, object-number & text)
getArrayColumns(): AdaptableColumn[];Returns
getBooleanColumns
Returns all boolean Columns
getBooleanColumns(): AdaptableColumn[];Returns
getColumnDataTypeForColumnId
Returns Data Type for the Column with given ColumnId
getColumnDataTypeForColumnId(columnId: string): AdaptableColumnDataType | undefined;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | Column to check |
Returns
AdaptableColumnDataType | undefined
getColumnIdForFriendlyName
Retrieves ColumnId for Column with given Friendly Name
getColumnIdForFriendlyName(friendlyName: string): string;Parameters
| Parameter | Type | Description |
|---|---|---|
| friendlyName | string | Friendly Name to Lookup |
Returns
string
getColumnIdsForFriendlyNames
Retrieves ColumnIds for Columns with given Friendly Names
getColumnIdsForFriendlyNames(friendlyNames: string[]): string[];Parameters
| Parameter | Type |
|---|---|
| friendlyNames | string[] |
Returns
string[]
getColumns
Returns all Columns available (including hidden, special)
getColumns(): AdaptableColumn[];Returns
getColumnsByColumnType
Returns all columns of a given columnType
getColumnsByColumnType(columnType: string): AdaptableColumn[];Parameters
| Parameter | Type | Description |
|---|---|---|
| columnType | string | the columnType to filter by |
Returns
getColumnSummaryForColumnId
Gets summary info for a column including filters and unique values
getColumnSummaryForColumnId(columnId: string): AdaptableColumnSummary;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | Column to summarise |
Returns
getColumnsWithColumnIds
Retrieves Adaptable Columns with given ColumnIds
getColumnsWithColumnIds(columnIds: string[]): AdaptableColumn[];Parameters
| Parameter | Type | Description |
|---|---|---|
| columnIds | string[] | Column Ids to lookup |
Returns
getColumnsWithDataType
Returns all Columns that have given DataType
getColumnsWithDataType(dataType: AdaptableColumnDataType): AdaptableColumn[];Parameters
| Parameter | Type | Description |
|---|---|---|
| dataType | AdaptableColumnDataType | the DataType of the Columns to retrieve |
Returns
getColumnsWithFriendlyNames
Retrieves Adaptable Columns with given Friendly names
getColumnsWithFriendlyNames(friendlyNames: string[]): AdaptableColumn[];Parameters
| Parameter | Type | Description |
|---|---|---|
| friendlyNames | string[] | Friendly Names to lookup |
Returns
getColumnTypes
Returns available columns types defined under columnOptions.columnTypes
getColumnTypes(): string[];Returns
string[]
getColumnWithColumnId
Retrieves AdapTable Column with given ColumnId
getColumnWithColumnId(columnId: string, logWarning?: boolean): AdaptableColumn | undefined;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | ColumnId to lookup |
| logWarning | boolean | Whether to log warning if Column missing |
Returns
AdaptableColumn | undefined
getColumnWithFriendlyName
Retrieves AdapTable Column with given Friendly name
getColumnWithFriendlyName(columnName: string, logWarning?: boolean): AdaptableColumn;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnName | string | Friendly Name to lookup |
| logWarning | boolean | Whether to log warning if Column missing |
Returns
getDateColumns
Returns all Date Columns
getDateColumns(): AdaptableColumn[];Returns
getDefaultAggFunc
Returns the default Aggregation Function for a Column
getDefaultAggFunc(columnId: string): string;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | Column to Check |
Returns
string
getExportableColumns
Returns all Exportable Columns
getExportableColumns(): AdaptableColumn[];Returns
getFilterableColumns
Returns all Sortable Columns
getFilterableColumns(): AdaptableColumn[];Returns
getFriendlyNameForColumnId
Retrieves Friendly Name of Column with given ColumnId
getFriendlyNameForColumnId(columnId: string, layout?: Layout): string;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | ColumnId to lookup |
| layout | Layout |
Returns
string
getFriendlyNamesForColumnIds
Retrieves Friendly Names for given ColumnIds
getFriendlyNamesForColumnIds(columnIds: string[]): string[];Parameters
| Parameter | Type | Description |
|---|---|---|
| columnIds | string[] | ColumnIds to lookup |
Returns
string[]
getGroupableColumns
Returns all Groupable Columns
getGroupableColumns(): AdaptableColumn[];Returns
getNonSpecialColumns
Returns all UI available columns excluding Action, FreeText and Calculated Columns
getNonSpecialColumns(): AdaptableColumn[];Returns
getNumberArrayColumns
Returns all number-array columns
getNumberArrayColumns(): AdaptableColumn[];Returns
getNumericArrayColumns
Returns all numeric array columns (number, tuple-number, object-number)
getNumericArrayColumns(): AdaptableColumn[];Returns
getNumericColumns
Returns all numeric Columns
getNumericColumns(): AdaptableColumn[];Returns
getObjectNumberArrayColumns
Returns all object-number-array columns e.g. [x:1,y:2,x:3,y:4]
getObjectNumberArrayColumns(): AdaptableColumn[];Returns
getPivotableColumns
Returns all Pivotable Columns
getPivotableColumns(): AdaptableColumn[];Returns
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.
getPrimaryKeyColumn(): AdaptableColumn | undefined;Returns
AdaptableColumn | undefined
getQueryableColumns
Returns all Queryable Columns
getQueryableColumns(): AdaptableColumn[];Returns
getRowGroupedColumns
Returns all columns currently Row Grouped
getRowGroupedColumns(): AdaptableColumn[];Returns
getSortableColumns
Returns all Sortable Columns
getSortableColumns(): AdaptableColumn[];Returns
getSpecialColumns
Returns any Action, FreeText and Calculated Columns
getSpecialColumns(): AdaptableColumn[];Returns
getTextArrayColumns
Returns all string array Columns
getTextArrayColumns(): AdaptableColumn[];Returns
getTextColumns
Returns all Text Columns
getTextColumns(): AdaptableColumn[];Returns
getTupleNumberArrayColumns
Returns all tuple-number-array columns e.g. [[1,2],[3,4]]
getTupleNumberArrayColumns(): AdaptableColumn[];Returns
getUIAvailableColumns
Returns all Columns that can be displayed in UI (excludes always hidden cols)
getUIAvailableColumns(): AdaptableColumn[];Returns
getUIHiddenColumns
Returns Columns that are always hidden in UI (but available for Expressions)
getUIHiddenColumns(): AdaptableColumn[];Returns
getVisibleColumns
Returns all visible Columns
getVisibleColumns(): AdaptableColumn[];Returns
hasArrayDataType
Checks if the Column with the given columnId has any Array-like DataType (TextArray,NumberArray,TupleNumberArray or ObjectNumberArray)
hasArrayDataType(columnId: string): boolean;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | Column ID |
Returns
boolean
hasBooleanDataType
Checks if the Column with the given columnId has DataType Boolean
hasBooleanDataType(columnId: string): boolean;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | Column ID |
Returns
boolean
hasColumnType
Checks if the Column with given Column Identifier (columnId or ColDef) has a specific Column Type
hasColumnType(columnIdentifier: string | ColDef, columnType: string): boolean;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnIdentifier | string | ColDef | ColumnId or ColDef to check |
| columnType | string | Column Type to check for |
Returns
boolean
hasDateDataType
Checks if the Column with the given columnId has DataType Date
hasDateDataType(columnId: string): boolean;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | Column ID |
Returns
boolean
hasNumberDataType
Checks if the Column with the given columnId has DataType Number
hasNumberDataType(columnId: string): boolean;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | Column ID |
Returns
boolean
hasNumericArrayDataType
Checks if the Column with the given columnId has an Numeric Array-like DataType (NumberArray,TupleNumberArray or ObjectNumberArray)
hasNumericArrayDataType(columnId: string): boolean;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | Column ID |
Returns
boolean
hasTextArrayDataType
Checks if the Column with the given columnId has a Text Array-like DataType (TextArray)
hasTextArrayDataType(columnId: string): boolean;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | Column ID |
Returns
boolean
hideColumn
Hides a Column from Grid
hideColumn(columnId: string): void;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | Column to hide |
Returns
void
isActionColumn
Checks if Column with given ColumnId is an Action Column
isActionColumn(columnId: string): boolean;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | ColumnId to check |
Returns
boolean
isAgGridGeneratedColumn
Whether column is auto generated by AG Grid (for selection, grouping, pivoting etc)
isAgGridGeneratedColumn(columnId: string): boolean;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | column to check |
Returns
boolean
isAutoRowGroupColumn
Checks if Column with given ColumnId is a row-group Column automatically generated by AG Grid
isAutoRowGroupColumn(columnId: string): boolean;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | ColumnId 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'
isAutoRowGroupColumnForMulti(columnId: string): boolean;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | ColumnId 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'
isAutoRowGroupColumnForSingle(columnId: string): boolean;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | ColumnId to check |
Returns
boolean
isCalculatedColumn
Checks if Column with given ColumnId is a Calculated Column
isCalculatedColumn(columnId: string): boolean;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | ColumnId to check |
Returns
boolean
isColumnInGrid
Returns true if the given Column exists in the Grid
isColumnInGrid(columnId: string): boolean;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | Column to check |
Returns
boolean
isFdc3Column
Checks if Column with given ColumnId is a FDC3 Column
isFdc3Column(columnId: string): boolean;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string |
Returns
boolean
isFreeTextColumn
Checks if Column with given ColumnId is a Free Text Column
isFreeTextColumn(columnId: string): boolean;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | ColumnId 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.
isPivotAggColumnWithNoPivotColumns(columnId: string): boolean;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | ColumnId to check |
Returns
boolean
isPivotResultColumn
Checks if Column with given ColumnId is a pivot Column automatically generated by AG Grid
isPivotResultColumn(columnId: string): boolean;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | ColumnId to check |
Returns
boolean
isSelectionColumn
Checks if Column with given ColumnId is a Selection (Checkbox) Column automatically generated by AG Grid
isSelectionColumn(columnId: string): boolean;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | ColumnId to check |
Returns
boolean
isSpecialColumn
Checks if Column with given ColumnId is a Special (i.e. calculated, freetext or action) Column
isSpecialColumn(columnId: string): boolean;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | ColumnId to check |
Returns
boolean
openColumnInfoSettingsPanel
Opens Settings Panel with Column Info section selected and visible
openColumnInfoSettingsPanel(): void;Returns
void
selectAllColumns
Selects all Columns
selectAllColumns(): void;Returns
void
selectColumn
Selects (highlights) a Column
selectColumn(columnId: string): void;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | Column to select |
Returns
void
selectColumns
Selects (highlights) group of Columns
selectColumns(columnIds: string[]): void;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnIds | string[] | columns to select |
Returns
void
setColumnCaption
Sets a new Caption / Header for a Column (only for current Layout)
setColumnCaption(columnId: string, caption: string): void;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | Column to Update |
| caption | string | New Caption to display |
Returns
void
showColumn
Makes a Column visible
showColumn(columnId: string): void;Parameters
| Parameter | Type | Description |
|---|---|---|
| columnId | string | Column to show |
Returns
void