Insert Method (HtmlElementCollection)

Inserts a html element into the HtmlElementCollection at the specified index.

Syntax

public void Insert( 
   HtmlElement element,
   int index
)

Parameters

element

Type: Zennolab.CommandCenter.HtmlElement

The document to insert.

index

Type: System.Int32

The zero-based index at which html element should be inserted.

Exceptions

Exception	Description
ArgumentOutOfRangeException	index is less than 0 or index is greater than Count.

Remarks

If index is equal to Count, item is added to the end of HtmlElementCollection.

Example

The following code example demonstrates the Insert method, along with various other properties and methods of the HtmlElementCollection.

// find elements by tag
HtmlElementCollection heCol = tab.FindElementsByTags("input:checkbox");
 
// find element by name
HtmlElement he = instance.GetTabByAddress("page").GetDocumentByAddress("0").FindElementByName("rad");
 
// if collection is invalid then return -1
if ((heCol.IsVoid) || (heCol.ErrorDetected)) return -1;
 
// insert element to collection
heCol.Insert(he, 0);

// find elements by tag
$heCol = $tab->FindElementsByTags("input:checkbox");
 
// find element by name
$he = $instance->GetTabByAddress("page")->GetDocumentByAddress("0")->FindElementByName("rad");
 
// if collection is invalid then return -1
if (($heCol->IsVoid) || ($heCol->ErrorDetected)) return -1;
 
// insert element to collection
$heCol->Insert($he, 0);

Requirements

Target Platforms: Desktop: Windows XP SP3 and older. Server: Windows Server 2003 and older.

Reference

HtmlElementCollection Class
HtmlElementCollection Members
Add Method
AddRange Method
InsertRange Method