FindChildByXPath Method

Searches for an element among the children by the xpath.

Syntax

public HtmlElement FindChildByXPath( 
   string xpath,
   int number
)

Parameters

xpath

Type: System.String

XPath for search the element.

number

Type: System.Int32

The document 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 FindChildByTag 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 element by id
    HtmlElement he = tab.FindElementById("main");
    if (he.IsVoid) return -2;
    // find child element by xpath
    HtmlElement heCh = he.FindChildByXPath("div[@id]", 0);
    if (heCh.IsVoid) return -3;
    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 element by id
    $he = $tab->FindElementById("main");
    if ($he->IsVoid) return -2;
    
    // find child element by xpath
    $heCh = $he->FindChildByXPath("div[@id]", 0);
    if ($heCh->IsVoid) return -3;
    return 0;
}

Requirements

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

Reference

HtmlElement Class
HtmlElement Members
FindChildByAttribute Method
FindChildById Method
FindChildByName Method
FindChildrenByAttribute Method
FindChildrenById Method
FindChildrenByName Method
FindChildrenByTags Method
FindChildrenByXPath Method
GetAttribute Method
GetSelectedItems Method
GetValue Method
RiseEvent Method
SetAttribute Method
SetSelectedItems Method
SetValue Method