RAD Studio VCL Reference
|
Shares the data belonging to another client dataset.
procedure CloneCursor(Source: TCustomClientDataSet; Reset: Boolean; KeepSettings: Boolean = False); override;
virtual __fastcall CloneCursor(TCustomClientDataSet Source, Boolean Reset, Boolean KeepSettings = False);
Call CloneCursor to share the data belonging to another IB client dataset.
Source indicates another TIBClientDataSet whose data is to be shared. If Source specifies any other type of client dataset, CloneCursor raises an exception.
Reset and KeepSettings determine how to set the values of the following properties and events:
Filter, Filtered, FilterOptions, and OnFilterRecord
IndexName
ReadOnly
RemoteServer and ProviderName
If Reset and KeepSettings are both false, the values of the properties listed above are all set to match the source dataset.
If Reset is true, the properties listed above are all cleared.
If Reset is false and KeepSettings is true, the properties listed above are not changed. In this case, the application must ensure that existing indexes, providers, and so on are compatible with the cloned data.
After calling CloneCursor, the data for the client dataset is the same as the data for Source. Edits performed by either client dataset are reflected in the data of both datasets.
Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
|
What do you think about this topic? Send feedback!
|