InsertRow Method

Inserts a blank row in the DataGrid.

DataGridObject.InsertRow(RowIndex)

Client support

   Newlook Smartclient

   Newlook Server

Use

InsertRow is similar to the AddRecord method (which also does an InsertRow) except that the resulting row is not associated with any existing Data Source.

As such, you can use this method call to add rows that will not get written to the database. Useful when you want to add a heading row to a grid.

NOTE!

Inserting a row using this method causes the index of every subsequent row and the row count property of the rows collection to increment by 1.

Arguments

RowIndex - (Integer, Required)

An integer which specifies where the new row will be inserted. If this value is n the new row will be inserted above the nth row in the rows collection. If this value is 0, the row will be inserted as the first row. Note the row index is a zero-based index.

Returns

Returns a Boolean value indicating the success or failure of the action.

ClosedExample

The following example adds a blank row to the top of the datagrid:

JSCRIPT:

function InsertFirstRow()

{

insertRowSuccess = App.ActiveForm.grdMyGrid.InsertRow (0);

if (insertRowSuccess == true){

//Code to populate new row

}

}

 
VB SCRIPT:

Sub InsertTopRow

InsertRowSuccess = App.ActiveForm.grdMyGrid.InsertRow (0)

If InsertRowSuccess = True

'Populate new row

End If

End Sub

Applies To

DataGrid control

See Also

AddRecord method | InsertColumn method | InsertColumnArray method | DeleteRow method

© 2004-2021 looksoftware. All rights reserved.