Интерфейс

humanemulator.net — справка. Продукт, демо и покупка — на хуманэмулятор.рф | Демо | Купить | API | лог изменений

send_key_up

send_key_up($key,$is_key=false); - данная функция используется для эмуляции на уровне событий отжатие заданной клавиши с клавиатуры. Может работать даже если программа находится в свернутом состоянии и в трее. (доступна с версии 4.6.31)

Функция на вход принимает параметры:

$key – клавивша, отжатие которой будет эмулирован. (string)

$is_key – при false, интерепретирует параметр key как код управляющей клавиши.

Если во время работы этой функции нажать Ctrl (или эмулировать нажатие через комманды set_ctrl_prefix) то посланная клавиша будет интерпритироваться как набор горячих клавиш для хумана.

После отработки функция возвращает результат своей работы в скрипт :

true – успешно эмулировали отжатие заданной клавиши(boolean)

false – операция не произведена (boolean)

Пример использования

<?php

// Scenario: Send key up event to a DOM element
// Description: For current page, find an input element and send a key up event to it
// Classes used: XHEInput, XHEInterface, XHEBrowser, XHEKeyboard, XHEApplication

// Connection string to XHE API
$xhe_host = "localhost:7010";

// Path to init.php file
if (!isset($path))
{
    // Path to init.php file for connecting to XHE API
    $path = "../../../Templates/init.php";
    // When connecting init.php file, all functionality of classes for working with XHE API will be available
    require($path);
}

// Navigate to
WEB::$browser->navigate(TEST_POLYGON_URL . "input.html");

// Get DOM element <input> by number
$targetInputNumber = 1;
$targetInput = DOM::$input->get_by_number($targetInputNumber);
echo(" \nTarget input inner number: $targetInput->inner_number");

// Check that DOM element was found
if ($targetInput->inner_number != -1) {
    // set focus
    $targetInput->focus();

    // Set En keyboard language
    SYSTEM::$keyboard->set_current_language("en");

    // Example 1: Send keyup to input by symbol;
    echo("\n1: Send keyup 's' to input by symbol: ");
    $sendKeyResult = $targetInput->send_key_up("s", false);
    if ($sendKeyResult)
        echo("true");
    else
        echo("false");

    // Example 2: Send keyup to input by code
    echo("\n1: Send keyup 'r' to input by alt code '114': ");
    $sendKeyResult = $targetInput->send_key_up(114, true);
    if ($sendKeyResult)
        echo("true");
    else
        echo("false");

    // Example 3: Send keyup 'tab' to input by code '9'
    echo("\n3: Send keyup to the input: ");
    $sendKeyResult = $targetInput->send_key_up(9, true);
    if ($sendKeyResult)
        echo("true");
    else
        echo("false");
}
echo("\n");


// Stop the application
WINDOW::$app->quit();
?>

# Additional paths
import sys
sys.path.insert(0, '../../../Templates PY/')

xhe_host = "127.0.0.1:7010"
from xweb_human_emulator import *

# начало
echo("<hr><font color=blue>interface.xxxxxxxxx</font><hr>")

# 1 
echo("1. Перейдем на яндекс : ")
echo(browser.navigate("http://ya.ru"),"<br>")

# 2 
echo("2. Получим нулевой ввод : ")
obj=input.get_by_number(0)
echo(obj.inner_number,"<br>")

# 3 
echo("3. Введем s (код 83) : ")
keyboard.set_current_language("en")
echo(obj.send_key_down(83)," ")
echo(obj.send_key_up(83),"<br>")
sleep(2)

# 4 
echo("4. Перейдем на msn : ")
echo(browser.navigate("http://msn.ru"),"<br>")
sleep(2)

# 5 
echo("5. Сдвинем страницу вниз (PgDown) по элементу с заданнйо точки : ")
obj=webpage.get_element_from_point(81,5)
echo(obj.send_key_down(34)," ")

# конец
echo("<hr><br>")

# Quit
app.quit()

#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 = "localhost:7010";
			InitXHE();

			// начало
			echo("<hr><font color=blue>interface.send_key_up</font><hr>");
							
			// 1 шаг
			echo("1. Перейдем на яндекс : ");
			echo(browser.navigate("http://ya.ru")+"<br>");
			
			// 2 шаг
			echo("2. Получим нулевой ввод : ");
			XHEInterface obj=input.get_by_number(0);
			echo(obj.inner_number+"<br>");
			
			// 3 шаг
			echo("3. Введем s (код 83) : ");
			keyboard.set_current_language("en");
			echo(obj.send_key_down("83",true)+" ");
			echo(obj.send_key_up("83",true)+"<br>");
			
			// 4 шаг
			echo("4. Перейдем на msn : ");
			echo(browser.navigate("http://msn.ru")+"<br>");
			sleep(2);
			
			// 5 шаг
			echo("5. Сдвинем страницу вниз (PgDown) по элементу с заданной точки : ");
			obj=webpage.get_element_from_point(81,5);
			echo(obj.send_key_down("34",true)+" ");

			// конец
			echo("\n\n");

			app.quit();            
	  }
}

// подключим функциональные объекты, если еще не подключен
xhe_host="127.0.0.1:7014";
echo=require("../../../Templates JS/init.js");

// начало
echo("<hr><font color=blue>keyboard.send_key_up</font><hr>");

// 1 шаг
echo("1. Перейдем на яндекс : ");
echo(browser.navigate("http://ya.ru")+"<br>");

// 2 шаг
echo("2. Получим нулевой ввод : ");
obj=input.get_by_number(0);
echo(obj.inner_number+"<br>");

// 3 шаг
echo("3. Введем s (код 83) : ");
keyboard.set_current_language("en");
echo(obj.send_key_down(83,true)+" ");
echo(obj.send_key_up(83,true)+"<br>");

// 4 шаг
echo("4. Перейдем на rpa-bot.ru/wiki/ : ");
echo(browser.navigate("https://rpa-bot.ru/wiki/")+"<br>");
browser.sleep(2);

// 5 шаг
echo("5. Сдвинем страницу вниз (PgDown) по элементу с заданнйо точки : ");
obj=webpage.get_element_from_point(81,5);
echo(obj.send_key_down(34,true)+" ");

// конец
echo("\n");

// Quit
app.quit();

=============================================
Interface Объекты DOM System Vision Web Window
=============================================
Если что-то непонятно или необходимо узнать или считаете что надо добавить по работе этой функции, пишите в комментарии или на наш форум.

Интерфейс

send_key_up

Функционал