borland Packages  Class Hierarchy  dx.dataset Package 

DataSetView component

java.lang.Object
   +----com.borland.dx.dataset.ReadRow
           +----com.borland.dx.dataset.ReadWriteRow
                   +----com.borland.dx.dataset.DataSet
                           +----com.borland.dx.dataset.DataSetView

About the DataSetView component

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.

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.


DataSetView constructors

DataSetView properties

*Read-only properties **Write-only properties

Properties implemented in this class

Properties implemented in com.borland.dx.dataset.DataSet

Properties implemented in com.borland.dx.dataset.ReadRow

Properties implemented in com.borland.dx.dataset.ReadWriteRow

Properties implemented in java.lang.Object

DataSetView methods

Methods implemented in com.borland.dx.dataset.DataSet

Methods implemented in com.borland.dx.dataset.ReadRow

Methods implemented in com.borland.dx.dataset.ReadWriteRow

Methods implemented in java.lang.Object

DataSetView event listeners


DataSetView constructors

DataSetView()

  public DataSetView()
Creates a DataSetView component.

DataSetView properties

masterLink

 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.

storageDataSet

 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.

DataSetView event listeners

This component is a source for the following event sets.

access

 public final void addAccessListener(AccessListener listener)
 public final void removeAccessListener(AccessListener listener)

dataChange

 public final void addDataChangeListener(DataChangeListener listener)
 public final void removeDataChangeListener(DataChangeListener listener)

masterNavigate

 public final void addMasterNavigateListener(MasterNavigateListener listener)
 public final void removeMasterNavigateListener(MasterNavigateListener listener)

navigation

 public final void addNavigationListener(NavigationListener listener)
 public final void removeNavigationListener(NavigationListener listener)

open

 public final void addOpenListener(OpenListener listener)
 public final void removeOpenListener(OpenListener listener)

rowFilter

 public final void addRowFilterListener(RowFilterListener listener)
 public final void removeRowFilterListener(RowFilterListener listener)

status

 public final void addStatusListener(StatusListener listener)
 public final void removeStatusListener(StatusListener listener)