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 java.lang.Object
DataSetView methods
- accessChange(com.borland.dx.dataset.AccessEvent)
- addRow(com.borland.dx.dataset.DataRow)
- allocateValues()
- atFirst()
- atLast()
- cancel()
- cancelLoading()
- cancelOperation()
- canNavigate(com.borland.dx.dataset.Column, int)
- canSet(com.borland.dx.dataset.Column)
- clearStatus()
- cloneDataSetView()
- close()
- columnIsVisible(java.lang.String)
- deleteAllRows()
- deleteRow()
- dittoRow(boolean)
- dittoRow(boolean, boolean)
- dropIndex()
- editRow()
- emptyAllRows()
- emptyRow()
- enableDataSetEvents(boolean)
- first()
- getDataRow(com.borland.dx.dataset.DataRow)
- getDataRow(int, com.borland.dx.dataset.DataRow)
- getDetail(java.lang.String)
- getDisplayVariant(int, int, com.borland.dx.dataset.Variant)
- getVariant(int, int, com.borland.dx.dataset.Variant)
- getVariant(java.lang.String, int, com.borland.dx.dataset.Variant)
- goToClosestRow(int)
- goToInternalRow(long)
- goToRow(com.borland.dx.dataset.ReadRow)
- goToRow(int)
- hasDetail(java.lang.String)
- hasValidations()
- inBounds()
- insertRow(boolean)
- interactiveLocate(java.lang.String, java.lang.String, int, boolean)
- isModified(int)
- isModified(java.lang.String)
- isNew(int)
- last()
- locate(com.borland.dx.dataset.ReadRow, int)
- lookup(com.borland.dx.dataset.ReadRow, com.borland.dx.dataset.DataRow, int)
- masterNavigated(com.borland.dx.dataset.MasterNavigateEvent)
- masterNavigating(com.borland.dx.dataset.MasterNavigateEvent)
- moveRow(int)
- next()
- open()
- openDetails()
- post()
- postAllDataSets()
- prior()
- refetchRow(com.borland.dx.dataset.ReadWriteRow)
- refilter()
- refresh()
- refreshSupported()
- resetInBounds()
- resetPendingStatus(boolean)
- resetPendingStatus(long, boolean)
- saveChanges()
- saveChangesSupported()
- setDefaultValues()
- setDisplayVariant(int, com.borland.dx.dataset.Variant)
- startEdit(com.borland.dx.dataset.Column)
- startEditCheck(com.borland.dx.dataset.Column)
- statusMessage(com.borland.dx.dataset.StatusEvent)
- statusMessage(int, java.lang.String)
- toggleViewOrder(java.lang.String)
- updateRow(com.borland.dx.dataset.DataRow)
- validate()
- validate(com.borland.dx.dataset.ReadRow)
- clearValues()
- requiredColumnsCheck()
- setBigDecimal(int, java.math.BigDecimal)
- setBigDecimal(java.lang.String, java.math.BigDecimal)
- setBoolean(int, boolean)
- setBoolean(java.lang.String, boolean)
- setByte(int, byte)
- setByte(java.lang.String, byte)
- setByteArray(int, byte[], int)
- setByteArray(java.lang.String, byte[], int)
- setDate(int, java.sql.Date)
- setDate(int, long)
- setDate(java.lang.String, java.sql.Date)
- setDate(java.lang.String, long)
- setDouble(int, double)
- setDouble(java.lang.String, double)
- setFloat(int, float)
- setFloat(java.lang.String, float)
- setInputStream(int, java.io.InputStream)
- setInputStream(java.lang.String, java.io.InputStream)
- setInt(int, int)
- setInt(java.lang.String, int)
- setLong(int, long)
- setLong(java.lang.String, long)
- setObject(int, java.lang.Object)
- setObject(java.lang.String, java.lang.Object)
- setShort(int, short)
- setShort(java.lang.String, short)
- setString(int, java.lang.String)
- setString(java.lang.String, java.lang.String)
- setTime(int, java.sql.Time)
- setTime(int, long)
- setTime(java.lang.String, java.sql.Time)
- setTime(java.lang.String, long)
- setTimestamp(int, java.sql.Timestamp)
- setTimestamp(int, long)
- setTimestamp(java.lang.String, java.sql.Timestamp)
- setTimestamp(java.lang.String, long)
- setVariant(int, com.borland.dx.dataset.Variant)
- setVariant(java.lang.String, com.borland.dx.dataset.Variant)
Methods implemented in java.lang.Object
- clone()
- equals(java.lang.Object)
- finalize()
- hashCode()
- notify()
- notifyAll()
- wait()
- wait(long)
- wait(long, int)
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)