ZennoLab Assemblies Documentation
FindElementByAttribute Method
See Also  Example Send Feedback
ZennoLab.CommandCenter Assembly > ZennoLab.CommandCenter Namespace > Document Class : FindElementByAttribute 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 by the attribute, and returns the first occurrence.

Syntax

C# 
public HtmlElement FindElementByAttribute( 
   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 element is not found then the IsVoid property and IsNull is true.

Example

The following code example demonstrates uses of the FindElementByAttribute 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 using "text" parameter
    HtmlElement he = tab.MainDocument.FindElementByAttribute("input:checkbox", "fulltag", "input:checkbox", "text", 0);
    if (he.IsVoid) return -1;
    // set value
    he.SetValue("True", instance.EmulationLevel, false);
            
    // find element using "regexp" parameter
    he = tab.MainDocument.FindElementByAttribute("input:radio", "fulltag", "input:radio", "regexp", 0);
    if (he.IsVoid) return -1;
    // set value
    he.SetValue("0", instance.EmulationLevel, false);
             
    // find element using "notext" parameter
    he = tab.MainDocument.FindElementByAttribute("textarea", "top", "288", "notext", 0);
    if (he.IsVoid) return -1;
    // set value
    he.SetValue("simple text", instance.EmulationLevel, false);
            
    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 using "text" parameter
    $he = $tab->MainDocument->FindElementByAttribute("input:checkbox", "fulltag", "input:checkbox", "text", 0);
    if ($he->IsVoid) return -1;
    // set value
    $he->SetValue("True", $instance->EmulationLevel, false);
            
    // find element using "regexp" parameter
    $he = $tab->MainDocument->FindElementByAttribute("input:radio", "fulltag", "input:radio", "regexp", 0);
    if ($he->IsVoid) return -1;
    // set value
    $he->SetValue("0", $instance->EmulationLevel, false);
             
    // find element using "notext" parameter
    $he = $tab->MainDocument->FindElementByAttribute("textarea", "top", "288", "notext", 0);
    if ($he->IsVoid) return -1;
    // set value
    $he->SetValue("simple text", $instance->EmulationLevel, false);
            
    return 0;
}

Requirements

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

See Also

© 2013 All Rights Reserved.