Description
Reports the next row that has been modified in the specified buffer.
Applies to
|
DataWindow type |
Method applies to |
|---|---|
|
PowerBuilder |
DataWindow control, DataWindowChild object, DataStore object |
Syntax
PowerBuilder
long dwcontrol.GetNextModified (long row, DWBuffer dwbuffer )
|
Argument |
Description |
|---|---|
|
dwcontrol |
A name of the DataWindow control, DataStore, or child DataWindow in which you want to locate the modified row. |
|
row |
A value identifying the row location after which you want to locate the modified row. To search from the beginning, specify 0. |
|
dwbuffer |
A value of the dwBuffer enumerated datatype identifying the DataWindow buffer in which you want to locate the modified row. For a list of valid values, see DWBuffer. |
Return value
Returns the number of the first row that was modified after row in dwbuffer in dwcontrol. Returns 0 if there are no modified rows after the specified row.
If any argument value is null, in PowerBuilder and JavaScript the method returns null.
Usage
PowerBuilder stores the update status of rows and columns in the DataWindow. The status settings indicate whether a row or column is new or has been modified. GetNextModified reports rows with the status NewModified! and DataModified!.
For more information on the status of rows and columns, see GetItemStatus and SetItemStatus.
Using GetNextModified on the delete buffer will return rows that have been modified and then deleted. The DeletedCount method will report the total number of deleted rows.
GetNextModified begins searching in the row after the value you specify in row. This is different from the behavior of Find, FindGroupChange, and FindRequired, which begin searching in the row you specify.
Total number of modified rows
You can use the ModifiedCount method to find out the total number of modified rows in the primary and filter buffers.
Examples
These statements count the number or rows that were modified in the primary buffer for dw_status and then display a message reporting the number modified:
integer rc
long NbrRows, ll_row = 0, count = 0
dw_status.AcceptText()
NbrRows = dw_status.RowCount()
DO WHILE ll_row <= NbrRows
ll_row = dw_status.GetNextModified(ll_row, Primary!)
IF ll_row > 0 THEN
count = count + 1
ELSE
ll_row = NbrRows + 1
END IF
LOOP
MessageBox("Modified Count", &
String(count) &
+ " rows were modified.")See also
