FindChildrenByName Method

Searches for all elements among the children by the name.

Syntax

public HtmlElementCollection FindChildrenByName( 
   string name
)

Parameters

name

Type: System.String

The name that defines search condition of HTML elements.

Return Value

Type: Zennolab.CommandCenter.HtmlElementCollection

The collection of elements that matches the conditions defined by the name, if found; otherwise, the Count property is "0".

Remarks

If html elements were not found then this method returns the HtmlElementCollection object in which IsVoid property is "true".

Example

The following code example demonstrates uses of the FindChildrenByName method.

public static int Execute(Instance instance, IZennoPosterProjectModel project)
{
    // clear cookie
    instance.ClearCookie();
    
    // go to lessons.zennolab.com
    Tab tab = instance.MainTab;
    if ((tab.IsVoid) || (tab.IsNull)) return -1;
    if (tab.IsBusy) tab.WaitDownloading();
    tab.Navigate("lessons.zennolab.com");
    if (tab.IsBusy) tab.WaitDownloading();
    
    // find element by id
    HtmlElement he = tab.FindElementById("main");
    
    // find all children by name
    HtmlElementCollection heCol = he.FindChildrenByName("text");
    
    return 0;
}

public static function Execute($instance, $project)
{
    // clear cookie
    $instance->ClearCookie();
    
    // go to lessons.zennolab.com
    $tab = $instance->MainTab;
    if (($tab->IsVoid) || ($tab->IsNull)) return -1;
    if ($tab->IsBusy) $tab->WaitDownloading();
    $tab->Navigate("lessons.zennolab.com");
    if ($tab->IsBusy) $tab->WaitDownloading();
    
    // find element by id
    $he = $tab->FindElementById("main");
    
    // find all children by name
    $heCol = $he->FindChildrenByName("text");
    
    return 0;
}

Requirements

Target Platforms: Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family, Windows Seven

Reference

HtmlElement Class
HtmlElement Members
FindChildByAttribute Method
FindChildById Method
FindChildByName Method
FindChildByTag Method
FindChildByXPath Method
FindChildrenByAttribute Method
FindChildrenById Method
FindChildrenByTags Method
FindChildrenByXPath Method
HtmlElementCollection Class