Интерфейс

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

send_key

send_key($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 event to a DOM element
// Description: For current page, find an input element and send a key 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 key to input by symbol;
    echo("\n1: Send key 's' to input by symbol: ");
    $sendKeyResult = $targetInput->send_key("s", false);
    if ($sendKeyResult)
		echo("true");
    else
		echo("false");
    
    // Example 2: Send key to input by code
    echo("\n1: Send key 'r' to input by alt code '114': ");
    $sendKeyResult = $targetInput->send_key(114, true);
    if ($sendKeyResult)
		echo("true");
    else
		echo("false");
         
    // Example 3: Send key 'tab' to input by code '9'
    echo("\n3: Send key to the input: ");
    $sendKeyResult = $targetInput->send_key(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. Сделаем поиск sr : ")
keyboard.set_current_language("en")
echo(obj.send_key("s",true)," ")
echo(obj.send_key(114,false)," ")
sleep(1)
echo(obj.send_key(13,false))

# конец
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</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. Сделаем поиск SR (код 83+82+13) : ");
			keyboard.set_current_language("en");
			echo(obj.send_key("83")+" ");
			echo(obj.send_key("82")+" ");
			sleep(1);
			echo(obj.send_key("13"));

			// конец
			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</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. Сделаем поиск SR (код 83+82+13) : ");
keyboard.set_current_language("en");
obj.focus();
echo(obj.send_key(83)+" ");
echo(obj.send_key(82)+" ");
browser.sleep(1);
echo(obj.send_key(13));

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

// Quit
app.quit();

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

Интерфейс

send_key

Функционал