DataTable

Creates an instance of DataTable

constructor

DataTable()

Creates an instance of DataTable with the given name.

constructor(aName: String)

DataTable(String aName)

Parameters:

• aName: A name of a new table.

Accepts all changes in rows of the table. After this method's call all rows should have status "Unchanged".

method acceptChanges

void acceptChanges()

Accepts changes for one particular row of the table. Checks that row is assigned and belongs to the current table.

method acceptChangesForRow(aRow: DataRow)

void acceptChangesForRow(DataRow aRow)

Parameters:

• aRow: A row to mark.

Add Dynamic Order condition

method addDynamicOrder(aFieldName: String; aDescending: Boolean)

void addDynamicOrder(String aFieldName, Boolean aDescending)

Parameters:

• aFieldName: field name
• aDescending: order

Creates and adds new row for the table. Returned ro has initializaed place to hold the data according to the table's scrtucture.

method addNewRow: DataRow

DataRow addNewRow()

Adds a subscriber to the table's notifications.

method addTableChangedListener(aListener: TableChangedListener)

void addTableChangedListener(TableChangedListener aListener)

Parameters:

• aListener: A subscriber/listener of notifications.

Adds a subscriber to the table's data changing notifications.

method addTableDataChangedListener(aListener: TableDataChangedListener)

void addTableDataChangedListener(TableDataChangedListener aListener)

Parameters:

• aListener: A subscriber/listener of notifications.

Sets the state of the table for further loading of data in it. Always call endLoadData after loading finished. While loading, no notifications are triggered.

method beginLoadData

void beginLoadData()

It's the method of logically opposite action to the acceptChanges - it reverts all changes id table's rows. After its call all rows are in "Unchanged" state with old data; all new rows are deleted, all deleted rows are restored.

method cancelChanges

void cancelChanges()

Reverts changes for one particular row of the current table. Checks that row is assigned and belongs to the current table. Note, that "Added' row will be detashed from the table.

method cancelChangesForRow(aRow: DataRow)

void cancelChangesForRow(DataRow aRow)

Parameters:

• aRow: A row to revert.

Removes all rows from the current table.

method clear

void clear()

Clones the current table along with its structure into newly creatd table object. No rows are copied, it affects structure and properties only.

method clone: DataTable

DataTable clone()

property Columns: DataColumnCollection read;

DataColumnCollection Columns { __get; }

Copies all table in new instance "as is". Additionally to clone it also copies data rows into new instance.

method copy: DataTable

DataTable copy()

This property is used for Dynamic Order feature.

property DynamicOrder: array of String read write;

String[] DynamicOrder { __get; __set; }

Resets the loading state of the table. Call it after beginLoadData and loading of the data itself. If data was loaded during loading state, correspondent events are fired on this method call.

method endLoadData

void endLoadData()

property ExtendedProperties: PropertyCollection read;

PropertyCollection ExtendedProperties { __get; }

Returns a collection of changed rows. Rows are not copied, it just a collection of references.

method getChangedRows: Collection<DataRow>

Collection<DataRow> getChangedRows()

The method is similar with getChangedRows with one difference though: a newly copy of table is created and filled with copies of changed rows from original table. Thus - on methoв return - you will have a table all rows of which are modified.

method getChanges: DataTable

DataTable getChanges()

Returns whether or not the table is in loading state.

method isDataLoading: Boolean

Boolean isDataLoading()

Returns whether or not the table has been initialized (i.e. table structure is filled with columns, primary keys (if any) are set).

method isInitialized: Boolean

Boolean isInitialized()

method loadDataRow(data: array of Object): DataRow

DataRow loadDataRow(Object[] data)

Parameters:

• data:

property PrimaryKey: array of DataColumn read write;

DataColumn[] PrimaryKey { __get; __set; }

Unsubscribes the given subscriber from the table notifications.

method removeTableChangedListener(aListener: TableChangedListener)

void removeTableChangedListener(TableChangedListener aListener)

Parameters:

• aListener: A subscriber to unsubscribe.

Unsubscribes the given subscriber from the table data changing notifications.

method removeTableDataChangedListener(aListener: TableDataChangedListener)

void removeTableDataChangedListener(TableDataChangedListener aListener)

Parameters:

• aListener: A subscriber to unsubscribe.

property Rows: DataRowCollection read;

DataRowCollection Rows { __get; }

property TableName: String read write;

String TableName { __get; __set; }

property Columns: DataColumnCollection read;

DataColumnCollection Columns { __get; }

This property is used for Dynamic Order feature.

property DynamicOrder: array of String read write;

String[] DynamicOrder { __get; __set; }

property ExtendedProperties: PropertyCollection read;

PropertyCollection ExtendedProperties { __get; }

property PrimaryKey: array of DataColumn read write;

DataColumn[] PrimaryKey { __get; __set; }

property Rows: DataRowCollection read;

DataRowCollection Rows { __get; }

property TableName: String read write;

String TableName { __get; __set; }

Creates an instance of DataTable

constructor

DataTable()

Creates an instance of DataTable with the given name.

constructor(aName: String)

DataTable(String aName)

Parameters:

• aName: A name of a new table.

Accepts all changes in rows of the table. After this method's call all rows should have status "Unchanged".

method acceptChanges

void acceptChanges()

Accepts changes for one particular row of the table. Checks that row is assigned and belongs to the current table.

method acceptChangesForRow(aRow: DataRow)

void acceptChangesForRow(DataRow aRow)

Parameters:

• aRow: A row to mark.

Add Dynamic Order condition

method addDynamicOrder(aFieldName: String; aDescending: Boolean)

void addDynamicOrder(String aFieldName, Boolean aDescending)

Parameters:

• aFieldName: field name
• aDescending: order

Creates and adds new row for the table. Returned ro has initializaed place to hold the data according to the table's scrtucture.

method addNewRow: DataRow

DataRow addNewRow()

Adds a subscriber to the table's notifications.

method addTableChangedListener(aListener: TableChangedListener)

void addTableChangedListener(TableChangedListener aListener)

Parameters:

• aListener: A subscriber/listener of notifications.

Adds a subscriber to the table's data changing notifications.

method addTableDataChangedListener(aListener: TableDataChangedListener)

void addTableDataChangedListener(TableDataChangedListener aListener)

Parameters:

• aListener: A subscriber/listener of notifications.

Sets the state of the table for further loading of data in it. Always call endLoadData after loading finished. While loading, no notifications are triggered.

method beginLoadData

void beginLoadData()

It's the method of logically opposite action to the acceptChanges - it reverts all changes id table's rows. After its call all rows are in "Unchanged" state with old data; all new rows are deleted, all deleted rows are restored.

method cancelChanges

void cancelChanges()

Reverts changes for one particular row of the current table. Checks that row is assigned and belongs to the current table. Note, that "Added' row will be detashed from the table.

method cancelChangesForRow(aRow: DataRow)

void cancelChangesForRow(DataRow aRow)

Parameters:

• aRow: A row to revert.

Removes all rows from the current table.

method clear

void clear()

Clones the current table along with its structure into newly creatd table object. No rows are copied, it affects structure and properties only.

method clone: DataTable

DataTable clone()

Copies all table in new instance "as is". Additionally to clone it also copies data rows into new instance.

method copy: DataTable

DataTable copy()

Resets the loading state of the table. Call it after beginLoadData and loading of the data itself. If data was loaded during loading state, correspondent events are fired on this method call.

method endLoadData

void endLoadData()

Returns a collection of changed rows. Rows are not copied, it just a collection of references.

method getChangedRows: Collection<DataRow>

Collection<DataRow> getChangedRows()

The method is similar with getChangedRows with one difference though: a newly copy of table is created and filled with copies of changed rows from original table. Thus - on methoв return - you will have a table all rows of which are modified.

method getChanges: DataTable

DataTable getChanges()

Returns whether or not the table is in loading state.

method isDataLoading: Boolean

Boolean isDataLoading()

Returns whether or not the table has been initialized (i.e. table structure is filled with columns, primary keys (if any) are set).

method isInitialized: Boolean

Boolean isInitialized()

method loadDataRow(data: array of Object): DataRow

DataRow loadDataRow(Object[] data)

Parameters:

• data:

Unsubscribes the given subscriber from the table notifications.

method removeTableChangedListener(aListener: TableChangedListener)

void removeTableChangedListener(TableChangedListener aListener)

Parameters:

• aListener: A subscriber to unsubscribe.

Unsubscribes the given subscriber from the table data changing notifications.

method removeTableDataChangedListener(aListener: TableDataChangedListener)

void removeTableDataChangedListener(TableDataChangedListener aListener)

Parameters:

• aListener: A subscriber to unsubscribe.