Progress
ADM 2 Reference


dataAvailable (data.p)

Sets the QueryPosition property for the SmartDataObject when the current record changes in some way. Possible settings for the QueryPosition property are FirstRecord (the new record is the first record of the RowObject dataset), LastRecord (the new record is the last record of the RowObject dataset,NotFirstOrLast, NoRecordAvailable or OnlyRecord.

Parameters:

INPUT pcRelative AS CHARACTER

A flag to indicate the state of the current record. It can be SAME, to indicate that the current record has been updated. In that case, DataAvailable is published to notify other objects that need to redisplay the record with its modified values; for example, a SmartDataViewer showing that record. Other objects, such as a SmartDataBrowser that is showing related records (for example, Orders of a modified Customer), ignore the event because the parent customer record has been modified, not repositioned to a different customer. Therefore, this version of dataAvailable will not change anything because the new record is the same as the old current record.

For other values of pcRelative, dataAvailable will RUN SUPER if there are ForeignFields, meaning that this is a dependent query to be reopened; the super procedure query.p will do this. Otherwise the SmartDataObject’s QueryPosition property is reset depending on the new relative position. It then republishes dataAvailable to let other related objects know that the record has changed.

Returns: Nothing (procedure)

Notes: This version of dataAvailable only sets the QueryPosition property to FirstRecord, LastRecord, or NotFirstOrLast. It relies on other procedures to set the other possible values.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095