borland Packages Class Hierarchy dx.dataset Package
java.lang.Object +----com.borland.dx.dataset.ReadRow +----com.borland.dx.dataset.ReadWriteRow +----com.borland.dx.dataset.DataSet +----com.borland.dx.dataset.DataSetView
Constructors Properties Methods Event Listeners
Implements AccessListener, Designable, MasterNavigateListener, StatusListener, Serializable, EventListener
The DataSetView
component extends DataSet
functionality by presenting an alternate view of the data in the DataSet
. The DataSetView
itself has no storage of data but sees all the unfiltered data contained in its storageDataSet
property to which you can apply a different sort order and filter criterion than the original StorageDataSet
. The navigation of the DataSetView
data is separate from that of its StorageDataSet
.
The use of a DataSetView
component is optional. If you only need a single sort or filter criterion at a time in your application, you may apply those settings directly on the QueryDataSet
, ProcedureDataSet
, or TableDataSet
. If however you wish to present the data in the DataSet
in multiple "views", the DataSetView
provides that capability without the need for multiple objects that each store data.
When a DataSetView
shares the data storage of a DataSet
with another DataSetView
, each DataSetView
sees edits that both make to the data. Calling the saveChanges()
method saves changes that were made to both. Both also share column properties such as edit and display masks, and so on. You cannot, however, display the DataSetView
component's columns in the JBuilder UI designer nor set its column properties (including persistent) through the UI or programmatically. This is because the DataSetView
component doesn't have its own data storage.
The DataSetView
component also allows for an additional level of indirection which provides for greater flexibility when changing the binding of your UI components. If you anticipate the need to rebind your
UI components and have several of them, bind the components to a DataSetView
instead of directly to the StorageDataSet
. When you need to rebind, change the DataSetView
component to the
appropriate StorageDataSet
, thereby making a single change that affects all UI components connected to the DataSetView
as well.
Warning: The DataSetView
component extends the functionality provided by its superclass (DataSet
). The close()
method is inherited by DataSetView
and has particular importance with this component as it must be called to ensure that the component is garbage collected. Otherwise, a DataSetView
component cannot be garbage collected until its associated StorageDataSet
is garbage collected.
public DataSetView()Creates a
DataSetView
component.
public final MasterLinkDescriptor getMasterLink() public synchronized void setMasterLink(MasterLinkDescriptor descriptor)Specifies the
MasterLinkDescriptor
object that describes the relationship between this DataSetView
and another DataSet
. The get
method is defined in DataSet
.
public synchronized void setStorageDataSet(StorageDataSet dataSetStore)Specifies the
StorageDataSet
object that contains the data storage that the DataSetView
component accesses. Use the storageDataSet
property of the DataSet
class to set this property. The get
method is defined in DataSet
.
public final void addAccessListener(AccessListener listener) public final void removeAccessListener(AccessListener listener)
public final void addDataChangeListener(DataChangeListener listener) public final void removeDataChangeListener(DataChangeListener listener)
public final void addMasterNavigateListener(MasterNavigateListener listener) public final void removeMasterNavigateListener(MasterNavigateListener listener)
public final void addNavigationListener(NavigationListener listener) public final void removeNavigationListener(NavigationListener listener)
public final void addOpenListener(OpenListener listener) public final void removeOpenListener(OpenListener listener)
public final void addRowFilterListener(RowFilterListener listener) public final void removeRowFilterListener(RowFilterListener listener)
public final void addStatusListener(StatusListener listener) public final void removeStatusListener(StatusListener listener)