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



System / excelfile



add_link

add_link($path,$sheet,$row,$col,$text,$address,$tip=""); - Добавить ссылку в ячейку

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

  • $path – Путь к файлу Excel
  • $sheet – Номер Листа
  • $row – Номер строки
  • $col – Колонка. Буквенное или цифровое значение
  • $text – значение для ячейки
  • $address – ссылка
  • $tip – всплывающая подсказка для ячейки

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

    Пример использования
    <?php
    
    // Scenario: Add links to Excel cells
    
    $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);
    }
    
    echo "\n<span >excelfile->" . basename(__FILE__) . "</span>\n";
    
    // Initialize Excel and prepare file path
    $filePath = "test/test.xlsx";
    SYSTEM::$excel->kill();
    
    // Example 1: Add web hyperlink
    echo("Example 1: Add web hyperlink : ");
    // Extract method arguments into variables
    $sheetIndex = 0;
    $row1 = 1;
    $column1 = "D";
    $linkText1 = "Yandex";
    $url1 = "https://yandex.ru";
    $tooltip1 = "yandex";
    $result = SYSTEM::$excelfile->add_link($filePath, $sheetIndex, $row1, $column1, $linkText1, $url1, $tooltip1);
    if ($result === true)
        echo("true\n");
    else
        echo("false\n");
    
    sleep(2);
    
    // Example 2: Add hyperlink to cell
    echo("\nExample 2: Add hyperlink to cell : ");
    // Extract method arguments into variables
    $row2 = 2;
    $linkText2 = "B1";
    $cellReference2 = "B1";
    $tooltip2 = "B1";
    $result = SYSTEM::$excelfile->add_link($filePath, $sheetIndex, $row2, $column1, $linkText2, $cellReference2, $tooltip2);
    if ($result === true)
        echo("true\n");
    else
        echo("false\n");
    
    // Example 3: Add hyperlink to cell in another sheet
    echo("\nExample 3: Add hyperlink to cell in another sheet : ");
    // Extract method arguments into variables
    $row3 = 3;
    $linkText3 = "new sheet";
    $cellReference3 = "'new sheet'!A1";
    $tooltip3 = "new sheet";
    $result = SYSTEM::$excelfile->add_link($filePath, $sheetIndex, $row3, $column1, $linkText3, $cellReference3, $tooltip3);
    if ($result === true)
        echo("true\n");
    else
        echo("false\n");
    
    
    
    // Close the file
    SYSTEM::$excel->close($filePath);
    
    // 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:7012"
    from xweb_human_emulator import *
    
    # начало
    echo("<hr><font color=blue>excelfile.set_sheet_name</font><hr>")
    
    # откроем
    path="test/test.xlsx";
    excel.kill();
    
    # 1
    echo("1. Добавим гиперссылку : ");
    echo(excel.add_link("test/test.xlsx",0,1,"D","Yandex","https://yandex.ru","yandex"));
    
    app.shell_execute("open",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>excelfile.set_sheet_name</font><hr>");
    
    			var path="test/test.xlsx";
    			excel.kill();
    
    			// 1
    			echo("1. Добавим гиперссылку : ");
    			echo(excelfile.add_link("test/test.xlsx",0,1,"D","Yandex","https://yandex.ru","yandex"));
    
    			app.shell_execute("open",path);
    
    			// конец
    			echo("\n\n");
    
    			app.quit();            
    	  }
    }
    xhe_host="127.0.0.1:7012";
    echo=require("../../../Templates JS/init.js");
    
    // начало
    echo("<hr><font color=blue>excelfile.get_cell</font><hr>");
    
    // откроем
    var path="test/test.xlsx";
    excel.kill();
    
    // 1
    echo("1. Добавим гиперссылку : ");
    echo(excelfile.add_link("test/test.xlsx",0,1,"D","Yandex","https://yandex.ru","yandex"));
    
    app.shell_execute("open",path);
    
    // конец
    echo("\n");
    
    // Quit
    app.quit();

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