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

copy_sheet

copy_sheet($path,$sheet_number,$newSheetName=''); - Копировать содержимое Листа и создать новый Лист с этим содержимым

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

  • $path – Путь к файлу Excel
  • $sheet_number – Номер Листа для копирования
  • $newSheetName – Название нового Листа (optional) (До 31 символа)

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

    Пример использования
    <?php
    
    // Scenario: Copy sheets 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 and prepare file path
    SYSTEM::$excel->kill();
    $filePath = DIRECTORY_SEPARATOR . "test" . DIRECTORY_SEPARATOR . "test.xlsx";
    $sourceSheetIndex = 0;
    
    // Example 1: Copy first sheet to new sheet with specific name
    echo("Example 1: Copy first sheet to new sheet with name 'New' : ");
    // Extract method arguments into variables
    $newSheetName1 = "New list";
    $result = SYSTEM::$excelfile->copy_sheet($filePath, $sourceSheetIndex, $newSheetName1);
    if ($result === true)
        echo("true\n");
    else
        echo("false\n");
    
    // Example 2: Copy first sheet to new sheet with empty name
    echo("\nExample 2: Copy first sheet to new sheet with empty name : ");
    // Extract method arguments into variables
    $newSheetName2 = "";
    $result = SYSTEM::$excelfile->copy_sheet($filePath, $sourceSheetIndex, $newSheetName2);
    if ($result === true)
        echo("true\n");
    else
        echo("false\n");
    
    // 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><blue>excelfile.copy_sheet</><hr>")
    
    excel.kill()
    
    echo("Тест 1. 1-ый Лист скопировать в новый  Лист с именем 'New'.\n")
    res = excelfile.copy_sheet("\\test\\test.xlsx", 0, "New list")
    echo("Результат выполнения: res\n")
    
    echo("Тест 2. 1-ый лист скопировать в новый Лист c пустым именем.\n")
    res = excelfile.copy_sheet("\\test\\test.xlsx", 0, "")
    echo("Результат выполнения: res\n")
    
    # посмотрим не работает
    app.shell_execute("open", "\\test\\test.xlsx")
    
    # конец
    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.copy_sheet</font><hr>");
    
                excel.kill();
    
                echo("Тест 1. 1-ый Лист скопировать в новый  Лист с именем 'New'. \n" );
                var res = excelfile.copy_sheet(Path.DirectorySeparatorChar + "test" + Path.DirectorySeparatorChar + "test.xlsx", 0, "New list");
                echo("Результат выполнения: $res\n");
    
                echo("Тест 2. 1-ый лист скопировать в новый Лист c пустым именем.\n" );
                res = excelfile.copy_sheet(Path.DirectorySeparatorChar + "test" + Path.DirectorySeparatorChar + "test.xlsx", 0, "");
                echo("Результат выполнения: $res\n");
    
    
    			// посмотрим
    			app.shell_execute("open", Path.DirectorySeparatorChar + "test" + Path.DirectorySeparatorChar + "test.xlsx");
    
    			// конец
    			echo("\n\n");
    
    			app.quit();
    	  }
    }
    
    
    /*
    <?php $xhe_host = "127.0.0.1:7010";
    
    // подключим функциональные объекты, если еще не подключен
    if (!isset($path))
      $path="../../../Templates/rpa-bot.ru/wiki/.php";
    require($path);
    
    // начало
    echo "<hr><span style=\"color: blue; \">excelfile->" .basename (__FILE__). "</span><hr>";
    
    $excel->kill();
    
    echo("Тест 1. 1-ый Лист скопировать в новый  Лист с именем 'New'. ". PHP_EOL);
    $res = $excelfile->copy_sheet(DIRECTORY_SEPARATOR . "test" . DIRECTORY_SEPARATOR . "test.xlsx", 0, "New list");
    echo("Результат выполнения: $res"  . PHP_EOL);
    
    echo("Тест 2. 1-ый лист скопировать в новый Лист c пустым именем." .  PHP_EOL);
    $res = $excelfile->copy_sheet(DIRECTORY_SEPARATOR . "test" . DIRECTORY_SEPARATOR . "test.xlsx", 0, "");
    echo("Результат выполнения: $res"  . PHP_EOL);
    
    // посмотрим
    $app->shell_execute("open", DIRECTORY_SEPARATOR . "test" . DIRECTORY_SEPARATOR . "test.xlsx");
    
    // конец
    echo "<hr><br>";
    
    // Quit
    $app->quit();
    ?>
    */
    xhe_host = "127.0.0.1:7010";
    
    // подключим функциональные объекты, если еще не подключен
    echo=require("../../../Templates JS/init.js");
    
    // начало
    echo("<hr><blue>excelfile.copy_sheet</><hr>");
    
    excel.kill();
    
    echo("Тест 1. 1-ый Лист скопировать в новый  Лист с именем 'New'.\n");
    res = excelfile.copy_sheet("\\test\\test.xlsx", 0, "New list");
    echo("Результат выполнения: res\n");
    
    echo("Тест 2. 1-ый лист скопировать в новый Лист c пустым именем.\n");
    res = excelfile.copy_sheet("\\test\\test.xlsx", 0, "");
    echo("Результат выполнения: res\n");
    
    // посмотрим не работает
    //app.shell_execute("open", "\\test\\est.xlsx");
    
    // конец
    echo("\n");
    
    // Quit
    app.quit();

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