FindChildrenByAttribute Method

Searches for all elements among the children by the attribute.

Syntax

public HtmlElementCollection FindChildrenByAttribute( 
   string tags,
   string attrName,
   string attrValue,
   string searchKind
)

Parameters

tags

Type: System.String

Tags for search the elements. If the count of tags is more than one then they are through ";".

attrName

Type: System.String

The attribute's name.

attrValue

Type: System.String

The attribute's value.

searchKind

Type: System.String

This parameter can take the following values: "text", "notext" and "regexp".

Return Value

Type: Zennolab.CommandCenter.HtmlElementCollection

The collection of elements that matches the conditions defined by the attribute, 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 FindChildrenByAttribute 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 attribute
    HtmlElementCollection heCol = he.FindChildrenByAttribute("input:checkbox", "fulltag", "input:checkbox", "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 attribute
    $heCol = $he->FindChildrenByAttribute("input:checkbox", "fulltag", "input:checkbox", "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
FindChildrenById Method
FindChildrenByName Method
FindChildrenByTags Method
FindChildrenByXPath Method
HtmlElementCollection Class