ZennoLab Assemblies Documentation
FindChildByAttribute Method
See Also  Example Send Feedback
ZennoLab.CommandCenter Assembly > ZennoLab.CommandCenter Namespace > HtmlElement Class : FindChildByAttribute Method
tags

Type: System.String

Tags for search the element. 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".

number

Type: System.Int32

The document's address.

Glossary Item Box

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

Syntax

C# 
public HtmlElement FindChildByAttribute( 
   string tags,
   string attrName,
   string attrValue,
   string searchKind,
   int number
)

Parameters

tags

Type: System.String

Tags for search the element. 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".

number

Type: System.Int32

The document's address.

Return Value

Type: Zennolab.CommandCenter.HtmlElement

The first element that matches the conditions defined by the attribute, 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 FindChildByAttribute 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 attribute
    HtmlElement heCh = he.FindChildByAttribute("input:checkbox", "fulltag", "input:checkbox", "text", 0);
    
    return 0;
}
PHPCopy 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 attribute
    $heCh = $he->FindChildByAttribute("input:checkbox", "fulltag", "input:checkbox", "text", 0);
    
    return 0;
}

Requirements

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

See Also

© 2014 All Rights Reserved.