FindElementByTag Method (Document)

Searches for an element by the tag.

Syntax

public HtmlElement FindElementByTag( 
   string tag,
   int number
)

Parameters

tag

Type: System.String

Tag for search the element.

number

Type: System.Int32

The document's address.

Return Value

Type: Zennolab.CommandCenter.HtmlElement

The first element that matches the conditions defined by the tag, 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 FindElementByTag 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 html element by tag
    HtmlElement he = tab.MainDocument.FindElementByTag("input:checkbox", 0);
     if (he.IsVoid) return -1;
    
    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 html element by tag
    $he = $tab->MainDocument->FindElementByTag("input:checkbox", 0);
     if ($he->IsVoid) return -1;
    
    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

Document Class
Document Members
FindElementByAttribute Method
FindElementById Method
FindElementByName Method
FindElementByXPath Method
FindElementsByAttribute Method
FindElementsById Method
FindElementsByName Method
FindElementsByTags Method
FindElementsByXPath Method