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

get_pos_by_text

get_pos_by_text($path,$sheet,$text,$exactly=true,$col="",$timeout=600); - получить позицию ячейки (Доступна с версии 7.0.58)

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

  • $path – путь к файлу
  • $sheet – номер листа (нумерация начинается с 0)
  • $text – искомый текст
  • $exactly – точное соответствие текста
  • $col – столбец в котором будет произведен поиск (если не задано - то ищется по всей таблице)
  • $timeout – время отводимое на операцию (в секундах)

    После отработки функция возвращает результат своей работы в скрипт :
  • позиция ячейки – позиция заданной ячейки : объект типа XHEPosition, с полями :

    • $x=""; // столбец
    • $y=-1; // строка
  • null – операция не удалась

    Пример использования
    <?php
    
    // Scenario: Get cell positions by text in Excel file
    
    $xhe_host = "localhost:7010";
    
    // Connect functional objects if not already connected
    if (!isset($path)){
        // Path to the init.php file for connecting to the XHE API
        $path = "../../../Templates/init.php";
        // Including init.php grants access to all classes and functionality for working with the XHE API
        require($path);
    }
    
    echo "\n<span >excelfile->" . basename(__FILE__) . "</span>\n";
    
    // Initialize Excel
    SYSTEM::$excel->kill();
    
    // Example 1: Get cell position with specified text
    echo("Example 1: Get cell position with specified text : ");
    // Extract method arguments into variables
    $filePath = "test/test.xlsx";
    $sheetIndex = 0;
    $searchText = "new";
    $caseSensitive = false;
    var_export(SYSTEM::$excelfile->get_pos_by_text($filePath, $sheetIndex, $searchText, $caseSensitive));
    
    // Example 2: Get cell position with specified text in specific column
    echo("\nExample 2: Get cell position with specified text in specific column : ");
    // Extract method arguments into variables
    $columnLetter = "D";
    var_export(SYSTEM::$excelfile->get_pos_by_text($filePath, $sheetIndex, $searchText, $caseSensitive, $columnLetter));
    
    // View result
    
    
    // End of script
    echo "\n";
    
    // Quit 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>excelfile.get_rows_count</font><hr>")
    
    # 1 
    echo("\n1. Получим позицию ячейки с заданным текстом: ");
    print(excelfile.get_pos_by_text("test\\test.xlsx",0,"new",false));
    
    # 2
    echo("\n2. Получим позицию ячейки с заданным текстом в заданом столбце: ");
    echo(excelfile.get_pos_by_text("test\\test.xlsx",0,"new",false,"D"));
    
    # конец
    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>excelfile.get_sheet_number_by_name</font><hr>");
    
    			// 1 
    			echo("\n1. Получим позицию ячейки с заданным текстом: ");
    			echo(excelfile.get_pos_by_text("test\\test.xlsx",0,"new",false).ToString());
    
    			// 2
    			echo("\n2. Получим позицию ячейки с заданным текстом в заданом столбце: ");
    			echo(excelfile.get_pos_by_text("test\\test.xlsx",0,"new",false,"D").ToString());
    
    			// конец
    			echo("\n\n");
    
    			app.quit();            
    	  }
    }
    xhe_host="127.0.0.1:7010";
    echo=require("../../../Templates JS/init.js");
    
    // начало
    echo("<hr><font color=blue>excelfile.get_rows_count</font><hr>");
    
    // 1 
    echo("\n1. Получим позицию ячейки с заданным текстом: ");
    console.log(excelfile.get_pos_by_text("test\\test.xlsx",0,"new",false));
    
    // 2
    echo("\n2. Получим позицию ячейки с заданным текстом в заданом столбце: ");
    console.log(excelfile.get_pos_by_text("test\\test.xlsx",0,"new",false,"D"));
    
    // конец
    echo("\n");
    
    // Quit
    app.quit();

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