FindElementByAttribute(String,String,String,String,String) Method

Searches for an HTML element by the attribute, and returns the first occurrence using extended number selector.

Syntax

public HtmlElement FindElementByAttribute( 
   string tags,
   string attrName,
   string attrValue,
   string searchKind,
   string 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 name.

attrValue

Type: System.String

The attribute value.

searchKind

Type: System.String

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

number

Type: System.String

The document address. This can be a number represented as a string or special expression for selection the desired number. The expression is constructed by the rules of the range of values. For example: random1(1,12-15,35-end).

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 FindElementByAttribute method.

public static int Execute(Instance instance, IZennoPosterProjectModel project)
{
    // clear cookie
    instance.ClearCookie();
    
    // go to lessons.zennolab.com
    Tab tab = instance.ActiveTab;
    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 attribute
    HtmlElement he = tab.FindElementByAttribute("input:checkbox", "fulltag", "input:checkbox", "text", "random");
    
    return 0;
}

public static function Execute($instance, $project)
{
    // clear cookie
    $instance->ClearCookie();
    
    // go to lessons.zennolab.com
    $tab = $instance->ActiveTab;
    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 attribute
    $he = $tab->FindElementByAttribute("input:checkbox", "fulltag", "input:checkbox", "text", "random");
    
    return 0;
}

Requirements

Target Platforms: Desktop: Windows XP SP3 and older. Server: Windows Server 2003 and older.

Reference

Tab Class
Tab Members
Overload List
FindElementById Method
FindElementByName Method
FindElementByTag Method
FindElementByXPath Method
FindElementsByAttribute Method
FindElementsById Method
FindElementsByName Method
FindElementsByTags Method
FindElementsByXPath Method
GetElementFromPoint Method