set_value_by_attribute_by_form_number

set_value_by_attribute_by_form_number($attr_name,$attr_value,$exactly,$value,$form_number,$frame=-1); - this function is used to set a value for a page element, finding it by the value of the specified attribute - in the form with the specified number.

the input Function accepts parameters:

  • $attr_name – name of the attribute to search for (string). To find out the attribute names of an element, you can use either the element inspector, the context menu, or view it in the list of elements.
  • $attr_value – the attribute value that we will use to search for an element in the specified form (string). To find out the value of a given attribute for an element, you can use either the element inspector, the context menu, or view it in the list of elements.
  • $exactly – exact match of the value of the specified attribute when searching for an element (boolean), if true - the value of the specified element attribute must completely match the passed parameter ($attr_value). if this parameter is set as false, the first element of the specified type in the form is found, where the value of the specified attribute contains the specified string ($attr_value). Starting from version 7.0.25, you can fart the value 2. then attr_value will be interpreted as a regular expression for the Java Script function String.search.
  • $value – the value that will be set to the element (string).
  • $form_number – the number of the form in which we are looking for the element (int). Form numbers start from zero and each frame has its own form numbering. You can find out the number of the form that contains the item you need from the task inspector, the context menu, and the list of items panel.
  • $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 the function returns the result of their work in the script (the return value type is boolean):
  • true – executed successfully
  • false to find this element failed (e.g. no items that meet the specified criteria or not this frame)

    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> textarea->".basename(__FILE__)."</font> <hr>";
     
    //1
    echo "1.Let's go to the polygon:";
    echo $browser->navigate("http://humanemulator.net/poligon/textarea.html")."<br>";
     
    //2
    echo "2.Let's set the text for the element named txt1 in the form with 1 number:";
    echo $textarea->set_value_by_name_by_form_number("txt3", "new text", 1)."<br>";
     
    //3
    echo "3.Let's set the text for a nonexistent element in the form:";
    if(!$textarea->set_value_by_name_by_form_number("list_ret", "new text", 1))
    echo "no such element <br>";
     
    //4
    echo "4.Let's set the text for the element in a nonexistent form:";
    if(!$textarea->set_value_by_name_by_form_number("txt3", "new text", 100500))
    echo "no such form <br>";
     
    //five
    echo "5.Let's set the text for the element named txt1 in the form with 1 number in the zero frame:";
    echo $textarea->set_value_by_name_by_form_number("txt3", "new text", 1,0)."<br>";
     
    //6
    echo "6.Let's set the text for a non-existent element in the form in the zero frame:";
    if(!$textarea->set_value_by_name_by_form_number("list_ret", "new text", 1,0))
    echo "no such element <br>";
     
    //7
    echo "7.Set the text for the element in a nonexistent form in the zero frame:";
    if(!$textarea->set_value_by_name_by_form_number("txt3", "new text", 100500,0))
    echo "no such form <br>";
     
    //8
    echo "8.Let's set the text for the element in the form in the non-existent frame:";
    if(!$textarea->set_value_by_name_by_form_number("txt3", "new text", 1,5))
    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:7010"
    from xweb_human_emulator import *
     
    # Start
    echo("<hr> <font color = blue> common.xxxxxxxxx </font> <hr>")
     
    # 1
    echo("1.Let's go to the polygon:")
    echo(browser.navigate("http://www.humanemulator.net/poligon/textarea.html"), "<br>")
     
    # 2
    echo("2.Let's set the text for the element named txt1 in the form with 1 number:")
    echo(textarea.set_value_by_name_by_form_number("txt3", "new text", 1), "<br>")
     
    # 3
    echo("3.Set the text for a nonexistent element in the form:")
    if not textarea.set_value_by_name_by_form_number("list_ret", "new text", 1):
    echo("no such item <br>")
     
    # 4
    echo("4.Set the text for the element in a nonexistent form:")
    if not textarea.set_value_by_name_by_form_number("txt3", "new text", 100500):
    echo("no such form <br>")
     
    # five
    echo("5.Let's set the text for the element named txt1 in the form with 1 number in the zero frame:")
    echo(textarea.set_value_by_name_by_form_number("txt3", "new text", 1,0), "<br>")
     
    # 6
    echo("6.Set the text for a non-existent element in the form in a zero frame:")
    if not textarea.set_value_by_name_by_form_number("list_ret", "new text", 1,0):
    echo("no such item <br>")
     
    # 7
    echo("7.Set the text for an element in a nonexistent form in a zero frame:")
    if not textarea.set_value_by_name_by_form_number("txt3", "new text", 100500,0):
    echo("no such form <br>")
     
    # 8
    echo("8.Set the text for an element in the form in a non-existent frame:")
    if not textarea.set_value_by_name_by_form_number("txt3", "new text", 1,5):
    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> set_value_by_name_by_form_number </font> <hr>");
     
    //1 step
    echo("1.Let's go to the polygon:");
    echo(browser.navigate("www.humanemulator.net/poligon/textarea.html") + "<br>");
     
    //step 2
    echo("2.Let's set the text for the element named txt1 in the form with 1 number:");
    echo(textarea.set_value_by_name_by_form_number("txt3", "new text", 1) + "<br>");
     
    //step 3
    echo("3.Set the text for a nonexistent element in the form:");
    if(!textarea.set_value_by_name_by_form_number("list_ret", "new text", 1))
    echo("no such element <br>");
     
    //step 4
    echo("4.Set the text for the element in a nonexistent form:");
    if(!textarea.set_value_by_name_by_form_number("txt3", "new text", 100500))
    echo("no such form <br>");
     
    //step 5
    echo("5.Let's set the text for the element named txt1 in the form with 1 number in the zero frame:");
    echo(textarea.set_value_by_name_by_form_number("txt3", "new text", 1, "0") + "<br>");
     
    //6 step
    echo("6.Let's set the text for a non-existent element in the form in a zero frame:");
    if(!textarea.set_value_by_name_by_form_number("list_ret", "new text", 1, "0"))
    echo("no such element <br>");
     
    //step 7
    echo("7.Set the text for the element in a nonexistent form in the zero frame:");
    if(!textarea.set_value_by_name_by_form_number("txt3", "new text", 100500, "0"))
    echo("no such form <br>");
     
    //step 8
    echo("8.Let's set the text for the element in the form in a nonexistent frame:");
    if(!textarea.set_value_by_name_by_form_number("txt3", "new text", 1, "5"))
    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> textarea.set_value_by_attribute_by_form_number </font> <hr>");
     
    //1 step
    echo("1.Let's go to the polygon:");
    echo(browser.navigate("http://www.humanemulator.net/poligon/textarea.html") + "<br>");
     
    //step 2
    echo("2.Let's set the text for the element named txt1 in the form with 1 number:");
    echo(textarea.set_value_by_name_by_form_number("txt3", "new text", 1) + "<br>");
     
    //step 3
    echo("3.Set the text for a nonexistent element in the form:");
    if(!textarea.set_value_by_name_by_form_number("list_ret", "new text", 1))
    echo("no such element <br>");
     
    //step 4
    echo("4.Set the text for the element in a nonexistent form:");
    if(!textarea.set_value_by_name_by_form_number("txt3", "new text", 100500))
    echo("no such form <br>");
     
    //step 5
    echo("5.Let's set the text for the element named txt1 in the form with 1 number in the zero frame:");
    echo(textarea.set_value_by_name_by_form_number("txt3", "new text", 1,0) + "<br>");
     
    //6 step
    echo("6.Set the text for a non-existent element in the form in a zero frame:");
    if(!textarea.set_value_by_name_by_form_number("list_ret", "new text", 1,0))
    echo("no such element <br>");
     
    //step 7
    echo("7.Set the text for the element in a nonexistent form in the zero frame:");
    if(!textarea.set_value_by_name_by_form_number("txt3", "new text", 100500,0))
    echo("no such form <br>");
     
    //step 8
    echo("8.Let's set the text for the element in the form in a nonexistent frame:");
    if(!textarea.set_value_by_name_by_form_number("txt3", "new text", 1,5))
    echo("no such frame <br>");
     
    //end
    echo("<hr> <br>");
     
    //Quit
    app.quit();