Language Reference Guide : System Classes : MatrixField Class : InsertChild Method
 
Share this page          
InsertChild Method
The InsertChild method inserts a field into a matrix field at a specified location.
This method has the following syntax:
smallint = MatrixField.InsertChild(fieldtoinsert =
          FormField [, row = integer][, column = integer])
This method has the following parameters:
fieldtoinsert
(Required) Identifies the field that is to be inserted
row
Specifies the row location in which to insert the field
column
Specifies the column location in which to insert the field
In a matrix field, the rows and columns are numbered from one, starting in the upper left corner and increasing as you move down and across. If you do not specify values for either row or column, OpenROAD assumes the default value of one.
You cannot insert a field into a nonexistent row or column. For example, if the matrix field has four columns, then the value for column cannot be greater than four.
When the method executes successfully, it returns a value of TRUE. If a field already occupies the specified position, the insertion is not done and the method returns a value of FALSE.