en:objects:listbox:get_option_info:get_length_by

get_length_by_name

get_length_by_name($name,$frame=-1); - this function is used to get the length (number of options) of the ListBox on the current page, finding it by the specified name.

the input Function accepts parameters:

$name – the name by which we find the element we need on the page (string). To find out the name of an element, you can use either the element inspector, the context menu, or view it in the list of elements.

$frame – the number of the frame in which we are looking for the element (string). Frame numbers start from zero. By default, -1 - the element is not in the frame. You can find out the number of the frame that contains the item you need from the task inspector, the context menu, and the item list panel.
With version 4.6.41 of postpone: you can pass nested frames, the principle is the same, a string is numbered frames separated by : for example, if you transfer "1:0:5" - will the selected frame number 1 in it under the frame with the number 0 and the subframe number 5
Since version 7.0.38, you can pass "url=>XXX", then search for the frame that contains the specified src, or pass "name=>XXX" - then the frame will be searched by the specified part of the name.

After testing, the function returns the result of its work to the script :

length – returns the length of the ListBox (number of options) (int)

false – it was not possible to find such a ListBox (for example, there are no elements that meet the specified criteria or there is no such frame), the return value type is boolean

PHP example:

<?php $xhe_host = "127.0.0.1:7014";
 
//connect the object to control the emulator, if not already connected
if(!isset($path))
  $path = "../../../Templates/xweb_human_emulator.php";
require($path);
 
//Start
echo "<hr> <font color = blue> listbox->".basename(__FILE__)."</font> <hr>";
 
//1
echo "1.Let's go to the polygon:";
echo $browser->navigate("http://humanemulator.net/poligon/listbox.html")."<br>";
 
//2
echo "2.Get the length of the element named contries:";
echo $listbox->get_length_by_name("contries")."<br>";
 
//3
echo "3.Get the length of a nonexistent element:";
if($listbox->get_length_by_name("ptych") == - 1)
echo "no such element <br>";
 
//4
echo "4.Get the length of the element named contries in frame zero:";
echo $listbox->get_length_by_name("contries", 0)."<br>";
 
//five
echo "5.Get the length of the nonexistent element in the zero frame:";
if($listbox->get_length_by_name("ptych", 0) == - 1)
echo "no such element <br>";
 
//6
echo "6.Get the length of an element in a non-existent frame:";
if($listbox->get_length_by_name("contries", 100500) == - 1)
echo "no such frame <br>";
 
//end
echo "<hr> <br>";
 
//Quit
$app->quit();
?>

Python example:

# Additional paths
import sys
sys.path.insert(0, '../../../Templates PY/')
 
xhe_host = "127.0.0.1:7011"
from xweb_human_emulator import *
 
# Start
echo("<hr> <font color = blue> listbox.xxxxxxxxx </font> <hr>")
 
# 1
echo("1.Let's go to the polygon:")
echo(browser.navigate("http://www.humanemulator.net/poligon/listbox.html"), "<br>")
 
# 2
echo("2.Get the length of the element named contries:")
echo(listbox.get_length_by_name("contries"), "<br>")
 
# 3
echo("3.Get the length of a nonexistent element:")
if listbox.get_length_by_name("ptych") == - 1:
echo("no such item <br>")
 
# 4
echo("4.Get the length of the element named contries in frame zero:")
echo(listbox.get_length_by_name("contries", 0), "<br>")
 
# five
echo("5.Get the length of a nonexistent element in frame zero:")
if listbox.get_length_by_name("ptych", 0) == - 1:
echo("no such item <br>")
 
# 6
echo("6.Get the length of an element in a non-existent frame:")
if listbox.get_length_by_name("contries", 100500) == - 1:
echo("no such frame <br>")
 
# end
echo("<hr> <br>")
 
# Quit
app.quit()

C# example:

#region using
 
using System;
using System.Diagnostics;
using System.Collections.Generic;
using System.Linq;
using System.IO;
using System.Text;
using System.Threading;
 
using XHE;
using XHE.XHE_DOM;
using XHE.XHE_System;
using XHE.XHE_Window;
using XHE.XHE_Web;
 
#endregion
 
 class Program: XHEScript
 {
static void Main(string [] args)
{
//init XHE
server = "127.0.0.1:7010";
InitXHE();
 
//Start
echo("<hr> <font color = blue> listbox.get_length_by_name </font> <hr>");
 
//1 step
echo("1.Let's go to the polygon:");
echo(browser.navigate("www.humanemulator.net/poligon/listbox.html") + "<br>");
 
//step 2
echo("2.Get the length of the element named contries:");
echo(listbox.get_length_by_name("contries") + "<br>");
 
//step 3
echo("3.Get the length of a nonexistent element:");
if(listbox.get_length_by_name("ptych") == - 1)
echo("no such element <br>");
 
//step 4
echo("4.Get the length of the element named contries in frame zero:");
echo(listbox.get_length_by_name("contries", "0") + "<br>");
 
//step 5
echo("5.Get the length of a nonexistent element in a zero frame:");
if(listbox.get_length_by_name("ptych", "0") == - 1)
echo("no such element <br>");
 
//step 6
echo("6.Get the length of the element in a non-existent frame:");
if(listbox.get_length_by_name("contries", "100500") == - 1)
echo("no such frame <br>");
 
//end
echo("<hr> <br>");
 
app.quit();
}
}

Java Script example:

//connect the object to control the emulator, if not already connected
xhe_host = "127.0.0.1:7010";
echo = require("../../../Templates JS/xweb_human_emulator.js");
 
//Start
echo("<hr> <font color = blue> listbox.get_length_by_name </font> <hr>");
 
//1 step
echo("1.Let's go to the polygon:");
echo(browser.navigate("http://www.humanemulator.net/poligon/listbox.html") + "<br>");
 
//step 2
echo("2.Get the length of the element named contries:");
echo(listbox.get_length_by_name("contries") + "<br>");
 
//step 3
echo("3.Get the length of a nonexistent element:");
if(!listbox.get_length_by_name("ptych"))
echo("no such element <br>");
 
//step 4
echo("4.Get the length of the element named contries in frame zero:");
echo(listbox.get_length_by_name("contries", 0) + "<br>");
 
//step 5
echo("5.Get the length of a nonexistent element in a zero frame:");
if(!listbox.get_length_by_name("ptych", 0))
echo("no such element <br>");
 
//step 6
echo("6.Get the length of the element in a non-existent frame:");
if(!listbox.get_length_by_name("contries", 100500))
echo("no such frame <br>");
 
//end
echo("<hr> <br>");
 
//Quit
app.quit();