Zennolab.CommandCenter
FindElementByAttribute Method
See Also  Example Send Feedback
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.

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.

Example

The following code example demonstrates uses of the FindElementByAttribute method.
C#Copy Code
public static int Execute(Instance instance)
{
    instance.ClearCookie();
 
    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();
            
    Document doc = tab.MainDocument;
    
    HtmlElement he = doc.FindElementByAttribute("input:checkbox", "fulltag", "input:checkbox", "text", 0);
    if (he.IsVoid) return -1;
 
    return 0;
}
PHPCopy Code
public static function Execute($instance)
{
    $instance->ClearCookie();
 
    $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();
            
    $doc = $tab->MainDocument;
    
    $he = $doc->FindElementByAttribute("input:checkbox", "fulltag", "input:checkbox", "text", 0);
    if ($he->IsVoid) return -1;
 
    return 0;
}

Remarks

If element is not found then the IsVoid property is true.

Requirements

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

See Also

© 2011 All Rights Reserved.