FireDAC.Comp.DataSet.TFDDataSet.CloneCursor

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

procedure CloneCursor(ASource: TFDDataSet; AReset: Boolean = False;  AKeepSettings: Boolean = False); virtual;

C++

virtual void __fastcall CloneCursor(TFDDataSet* ASource, bool AReset = false, bool AKeepSettings = false);

Properties

Type Visibility Source Unit Parent
procedure
function
public
FireDAC.Comp.DataSet.pas
FireDAC.Comp.DataSet.hpp
FireDAC.Comp.DataSet TFDDataSet

Description

Shares the data belonging to another dataset.

Use CloneCursor to share the data belonging to another dataset with this dataset. After calling CloneCursor, the internal data storage is physically the same for this dataset and for the ASource dataset. 

ASource is the reference to a dataset whose data will be shared with this dataset. 

AReset and AKeepSettings determine how to set the values of the following properties and events:

If AReset and AKeepSettings are both False, the values of the properties listed above are all set to match the source dataset. 

If AReset is True, the properties listed above are all set to the default values. 

If AReset is False and AKeepSettings is True, the properties listed above are not changed. In this case, the application must ensure that existing indexes, filters, and so on are compatible with the cloned data. 

CloneCursor does not clone:

  • Persistent fields.
  • Adapter / update object.
  • Event handlers, excluding OnFilterRecord.

Example

FDMemTable1.CloneCursor(FDQuery1, True, False);
FDMemTable1.Locate(...);
FDMemTable1.Edit;
...

See Also

Samples