<< Return to Main Index

< Return to Class Index

CGXDBToolsEngine::CGXDBToolsEngine

CGXDBToolsEngine();

CGXDBToolsEngine(RWDBTable table, RWDBSchema updateCols, RWDBConnection conn);

table

Specifies the table to be displayed.

updateCols

Specifies the unique-identifier fields to be used in the updater, deleter and inserter.

conn

Specifies the connection used by the updater, deleter and inserter.

CGXDBToolsEngine(RWDBTable table, RWDBSelector selector, RWDBSchema visibleCols, RWDBSchema updateCols,  RWDBConnection conn);

table

Specifies the table to be displayed.

selector

Specifies the selection criterion.

visibleCols

Fields specified in the selector.

updateCols

Specifies the unique-identifier fields to be used in the updater, deleter and inserter.

conn

Specifies the connection used by the updater, deleter and inserter.

CGXDBToolsEngine(RWDBSelector selector, RWDBConnection conn);

selector

Specifies the selector specifying a join.

conn

Specifies the connection used by the updater, deleter and inserter.

Remarks

Use the default constructor to create an uninitialized engine and initialize it at a later time using Init.

Use the second variant to create and initialize the engine with a whole table.

Use the third variant to create and initialize the engine with a table but with selection criteria specified in selector. Specifying the updateCols makes the update, delete and insert operations efficient. The where clause will be built with the field values in the updateCols. This necessitates the engine to fetch the updateCols fields if they are not already part of the selector. But there is no way the engine can tell which fields are included in the selector, so you need to specify the fields included in the selector using visbleCols.

Use the fourth variant to initialize the engine with a join as specified in the selector. The resultant engine (and the grid) will be read-only.

To re-initialize the engine, use the appropriate Init method.

See Also

CGXDBToolsEngine::Init

CGXDBToolsEngine

Class Overview | Class Members