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


System / excel


set_range_name

set_range_name($path,$sheet,$begin_cell,$end_cell,$name,$timeout=3000); - Задать имя диапазона

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

  • $path – Путь к файлу Excel
  • $sheet – Номер Листа
  • $begin_cell – адрес ячейки начала диапазона. Пример: "A1"
  • $end_cell – адрес ячейки конца диапазона. Пример: "A10"
  • $name – название диапазона
  • $timeout – Таймаут ожидания выполнения операции, сек

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

    Пример использования
    <?php
// Scenario: Set a name for a range of cells in an Excel file
$xhe_host = getenv("RPABOT_HOST_URL");
// Connect functional objects if not already connected
if (!isset($path)){
  $path = "../../../Templates/init.php";
  require($path);
}

// beginning
echo "\n<span >excelfile->".basename (__FILE__)."</span>\n";

// Kill existing Excel processes
SYSTEM::$excel->kill();

// Example 1: Set a name for a range of cells
// Set arguments as variables
$filePath = "test/test.xlsx";
$sheetIndex = 0;
$startCell = "A1";
$endCell = "C3";
$rangeName = "__Name__";

echo("\n\n1. Set a name for a range of cells: ");
$result = SYSTEM::$excel->set_range_name($filePath, $sheetIndex, $startCell, $endCell, $rangeName);
if ($result) {
    echo("Success - Range '$startCell:$endCell' named as '$rangeName'\n");
} else {
    echo("Failed - Could not name range '$startCell:$endCell' as '$rangeName'\n");
}

// end
echo "\n";

// Quit
WINDOW::$app->quit();
?>
    c# Additional paths
import sys
sys.path.insert(0, '../../../Templates PY/')

xhe_host = "127.0.0.1:7027"
from xweb_human_emulator import *

# начало
echo("<hr><font color=blue>excelfile.set_sheet_name</font><hr>")

# 1
echo("1. Задать  имя диапазона  ");
echo(excel.set_range_name("test/test.xlsx",0,"A1","D5","__Name__"));

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 = Environment.GetEnvironmentVariable("RPABOT_HOST_URL");
			InitXHE();

			// начало
			echo("<hr><font color=blue>excelfile.set_sheet_name</font><hr>");

			// 1 
			echo("1. Задать имя диапазона: ");
			echo(excel.set_range_name("test\\test.xlsx",0,"B2","D10","__Name__"));

			app.shell_execute("open","test/test.xlsx");
			
			// конец
			echo("\n\n");

			app.quit();            
	  }
}
    xhe_host="127.0.0.1:7027";
echo=require("../../../Templates JS/init.js");

// начало
echo("<hr><font color=blue>excelfile.get_cell</font><hr>");

// 1 
echo("1. Задать имя диапазона: ");
echo(excel.set_range_name("test\\test.xlsx",0,"B2","D10","__Name__"));

app.shell_execute("open","test/test.xlsx");

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

// Quit
app.quit();

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