FindElementById Method (Document)

Searches for an element by the ID, and returns the first occurrence.

Syntax

public HtmlElement FindElementById( 
   string id
)

Parameters

id

Type: System.String

The ID that defines search condition of HTML elements.

Return Value

Type: Zennolab.CommandCenter.HtmlElement

The first element that matches the conditions defined by the ID, 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 FindElementById 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 id
    HtmlElement he = tab.MainDocument.FindElementById("overview");
    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 id
    $he = $tab->MainDocument->FindElementById("overview");
    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
FindElementByName Method
FindElementByTag Method
FindElementByXPath Method
FindElementsByAttribute Method
FindElementsById Method
FindElementsByName Method
FindElementsByTags Method
FindElementsByXPath Method