Основной сайт хуманэмулятор.рф  |  Демо  |  Купить  |  API  |  Wiki



System / excel



cut_range_and_paste_to_range

cut_range_and_paste_to_range($path,$src_sheet,$target_sheet,$src_begin_cell,$src_end_cell,$target_begin_cell,$target_end_cell,$timeout=3000); - Вырезать значения ячеек из диапазона и вставить значения в другой диапазон

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

  • $path – Путь к файлу Excel
  • $src_sheet – Номер Листа диапазона, для того чтобы вырезать значения
  • $target_sheet – Номер Листа диапазона, для того чтобы вставить значения
  • $src_begin_cell – адрес ячейки начала диапазона, для того чтобы вырезать значения. Пример: "A1"
  • $src_end_cell – адрес ячейки начала диапазона, для того чтобы вырезать значения. Пример: "A10"
  • $target_begin_cell – адрес ячейки начала диапазона, для того чтобы вставить значения. Пример: "A1"
  • $target_end_cell – адрес ячейки конца диапазона, для того чтобы вставить значения. Пример: "A10"
  • $timeout – Таймаут ожидания выполнения операции, сек

    После выполнения функции возвращаемое значение будет равно одному из двух :
  • true – успешно
  • false – не удалось

    Пример использования
    <?php 
    // Scenario: Demonstrates how to cut a range of cells and paste it to another range in Excel
    
    $xhe_host = getenv("RPABOT_HOST_URL");
    // 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);
    }
    
    // Kill all Excel processes
    SYSTEM::$excel->kill();
    
    // Example 1: Open Excel file
    echo("\nExample 1: Open Excel file\n");
    
    // Set variables for method arguments
    $filePath = "test/test.xlsx";
    $visible = false;
    $readOnly = true;
    
    // Open Excel file
    $result = SYSTEM::$excel->open($filePath, $visible, $readOnly);
    if ($result) {
        echo("Successfully opened Excel file: $filePath\n");
    } else {
        echo("Failed to open Excel file: $filePath\n");
    }
    
    // Example 2: Set row values
    echo("\nExample 2: Set row values\n");
    
    // Set variables for method arguments
    $sheetIndex = 1;
    $rowIndex = 1;
    $rowData = array('Завод "Э"', 2, 3, 4, 5, 6, 7, 8);
    
    // Set row values
    $result = SYSTEM::$excel->set_row($filePath, $sheetIndex, $rowIndex, $rowData);
    if ($result) {
        echo("Successfully set values for row $rowIndex\n");
    } else {
        echo("Failed to set values for row $rowIndex\n");
    }
    
    // Example 3: Cut range and paste to range
    echo("\nExample 3: Cut range and paste to range\n");
    
    // Set variables for method arguments
    $sourceSheetIndex = 1;
    $targetSheetIndex = 4;
    $sourceRangeStart = "A1";
    $sourceRangeEnd = "H10";
    $targetRangeStart = "A1";
    $targetRangeEnd = "H10";
    
    // Cut range and paste to range
    $result = SYSTEM::$excel->cut_range_and_paste_to_range($filePath, $sourceSheetIndex, $targetSheetIndex, $sourceRangeStart, $sourceRangeEnd, $targetRangeStart, $targetRangeEnd);
    if ($result) {
        echo("Successfully cut range from $sourceRangeStart:$sourceRangeEnd and pasted to $targetRangeStart:$targetRangeEnd\n");
    } else {
        echo("Failed to cut range from $sourceRangeStart:$sourceRangeEnd and paste to $targetRangeStart:$targetRangeEnd\n");
    }
    
    // Example 4: Save Excel file
    echo("\nExample 4: Save Excel file\n");
    
    // Save Excel file
    $result = SYSTEM::$excel->save($filePath);
    if ($result) {
        echo("Successfully saved Excel file: $filePath\n");
    } else {
        echo("Failed to save Excel file: $filePath\n");
    }
    
    // Wait for 3 seconds to observe the result
    sleep(3);
    
    // Example 5: Close Excel file
    echo("\nExample 5: Close Excel file\n");
    
    // Close Excel file
    $result = SYSTEM::$excel->close($filePath);
    if ($result) {
        echo("Successfully closed Excel file: $filePath\n");
    } else {
        echo("Failed to close Excel file: $filePath\n");
    }
    
    // Quit 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>excel.cut_range_and_paste_to_range</font><hr>")
    
    path = "test/test.xlsx"
    
    excel.kill()
    echo("1. Откроем: ")
    echo(excel.open(path, false, true))
    
    echo("\n2. Создать значения для строки: ")
    echo(excel.set_row(path, 1, 1, array('Завод "Э"', 2, 3, 4, 5, 6, 7, 8)))
    
    echo("\n3. Вырезать и вставить диапазоны: ")
    echo(excel.cut_range_and_paste_to_range(path, 1, 4, "A1", "H10", "A1", "H10"))
    
    echo("\n4. Сохранить: ")
    excel.save(path)
    
    # Для наблюдения за результатом работы
    app.pause(3)
    echo("\n5. Закрыть: ")
    excel.close(path)
    
    # конец
    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 = Environment.GetEnvironmentVariable("RPABOT_HOST_URL");
    			InitXHE();
    
    			// начало
    			echo("<hr><font color=blue>excel.set_sheet_name</font><hr>");
    
                var path = "test/test.xlsx";
    
    			// 1 
    			excel.kill();
    			echo("1. Откроем: ");
    			echo(excel.open(path, false,true));
    
    			echo("\n2. Создать значения для строки: ");
                echo(excel->set_row($path, 1, 1, array('Завод "Э"', 2, 3, 4, 5, 6, 7, 8)));
                echo("\n3. Вырезать и вставить диапазоны: ");
                echo(excel->cut_range_and_paste_to_range($path, 1, 4, "A1", "H10", "A1", "H10"));
                echo("\n4. Сохранить: ");
                excel->save($path);
                // Для наблюдения за результатом работы
                sleep(3);
                echo("\n5. Закрыть: ");
                excel->close($path);
    
        		// конец
    			echo("\n\n");
    
    			app.quit();            
    	  }
    }
    xhe_host="127.0.0.1:7040";
    echo = require("../../../Templates JS/init.js");
    
    // начало
    echo("<hr><font color=blue>excel.copy_range_and_paste_to_range</font><hr>");
    
    const path = "test/test.xlsx";
    
    excel.kill();
    echo("1. Откроем: ");
    echo(excel.open(path, false, true));
    
    echo("\n2. Создать значения для строки: ");
    echo(excel.set_row(path, 1, 1,  ['Завод "Э"', 2, 3, 4, 5, 6, 7, 8]));
    
    echo("\n3. Вырезать и вставить диапазоны: ");
    echo(excel.cut_range_and_paste_to_range(path, 1, 4, "A1", "H10", "A1", "H10"));
    
    echo("\n4. Сохранить: ");
    excel.save(path);
    
    // Для наблюдения за результатом работы
    app.sleep(3);
    echo("\n5. Закрыть: ");
    excel.close(path);
    
    // конец
    echo("\n");
    
    app.quit();

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