InsertRow
method (DataWindows)
Description
Inserts a row in a DataWindow or DataStore. If any columns have
default values, the row is initialized with these values before it is
displayed.
Applies to
|
DataWindow type |
Method applies to |
|---|---|
|
PowerBuilder |
DataWindow control, DataWindowChild object, DataStore |
Syntax
PowerBuilder
|
1 |
long dwcontrol.InsertRow ( long row ) |
|
Argument |
Description |
|---|---|
|
dwcontrol |
A reference to a DataWindow control, DataStore, or |
|
row |
A value identifying the row before which you want to |
Return value
Returns the number of the row that was added if it succeeds and -1
if an error occurs.
If any argument’s value is null, in PowerBuilder and JavaScript the
method returns null. If there is no DataWindow object assigned to the
DataWindow control or DataStore, this method returns -1.
Usage
InsertRow simply inserts the row without changing the display or the
current row. To scroll to the row and make it the current row, call
ScrollToRow. To simply make it the current row, call SetRow.
A newly inserted row (with a status flag of New!) is not included in
the modified count until data is entered in the row (its status flag
becomes NewModified!).
Examples
This statement inserts an initialized row before row 7 in
dw_Employee:
|
1 |
dw_Employee.InsertRow(7) |
This example inserts an initialized row after the last row in
dw_employee, then scrolls to the row, which makes it current:
|
1 2 3 |
long ll_newrow ll_newrow = dw_employee.InsertRow(0) dw_employee.ScrollToRow(ll_newrow) |
See also