Searches for an element among the children by the name, and returns the first occurrence.

Syntax

C#
public HtmlElement FindChildByName( string name )

Parameters

name

Type: System.String

The name that defines search condition of HTML elements.

Return Value

Type: Zennolab.CommandCenter.HtmlElement

The first element that matches the conditions defined by the name, if found; otherwise, the result is void.

Remarks

If html element was not found then this method returns the HtmlElement object in which IsVoid or IsNill property is "true".

Example

The following code example demonstrates uses of the FindChildByName method.

C#	Copy Code
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 child element by name HtmlElement heCh = he.FindChildByName("text"); return 0; }

Copy Code

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 child element by name
    HtmlElement heCh = he.FindChildByName("text");
    
    return 0;
}

PHP	Copy Code
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 child element by name $heCh = $he->FindChildByName("text"); return 0; }

PHP

Copy Code

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 child element by name
    $heCh = $he->FindChildByName("text");
    
    return 0;
}

Requirements

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