Справка Human Emulator excel: merge

Интерфейс

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

merge_cells

merge_cells($path,$sheet,$begin_address,$end_address,$across=false); - Объединить ячейки

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

$path – Путь к файлу Excel

$sheet – Номер Листа

$begin_address – Начало диапазона

$end_address – Конец диапазона

$across – Если true, объединить ячейки в каждой строке указанного диапазона. Если false, объединить все ячейки.

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

true – успешно

false – не удалось

Пример использования

<?php 
// Scenario: Demonstrates how to merge and unmerge cells in an Excel sheet

$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);
}

// Set variables for method arguments
$filePath = "test/test.xlsx";
$sheetIndex = 0;
$cellRangeStart = "A1";
$cellRangeEnd = "D1";
$visible = true;
$debug = true;

// Example 1: Kill any existing Excel processes and open the file
echo("\nExample 1: Kill any existing Excel processes and open the file\n");
$result1 = SYSTEM::$excel->kill();
if ($result1) {
    echo("Successfully killed existing Excel processes\n");
} else {
    echo("Failed to kill existing Excel processes\n");
}

$result2 = SYSTEM::$excel->open($filePath, $visible, $debug);
if ($result2) {
    echo("Successfully opened Excel file: $filePath\n");
} else {
    echo("Failed to open Excel file: $filePath\n");
}

// Example 2: Merge cells in the specified range
echo("\nExample 2: Merge cells in the specified range\n");
$result3 = SYSTEM::$excel->merge_cells($filePath, $sheetIndex, $cellRangeStart, $cellRangeEnd);
if ($result3) {
    echo("Successfully merged cells from $cellRangeStart to $cellRangeEnd\n");
} else {
    echo("Failed to merge cells from $cellRangeStart to $cellRangeEnd\n");
}

// Pause to observe the result
sleep(10);

// Example 3: Unmerge cells in the specified range
echo("\nExample 3: Unmerge cells in the specified range\n");
$result4 = SYSTEM::$excel->unmerge_cells($filePath, $sheetIndex, $cellRangeStart, $cellRangeEnd);
if ($result4) {
    echo("Successfully unmerged cells from $cellRangeStart to $cellRangeEnd\n");
} else {
    echo("Failed to unmerge cells from $cellRangeStart to $cellRangeEnd\n");
}

// Pause to observe the result
sleep(10);

// Example 4: Close the Excel file
echo("\nExample 4: Close the Excel file\n");
$result5 = SYSTEM::$excel->close($filePath);
if ($result5) {
    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>excelfile.set_sheet_name</font><hr>")

excel.kill();
path = "test/test.xlsx";
excel.open(path,false,true);
sleep(2);

# 1
echo("1. Объединить ячейки  : ");
echo(excel.merge_cells(path,0,"A1","D1"));

sleep(10);

# 1
echo("\n2. Разъединить ячейки  : ");
echo(excel.unmerge_cells(path,0,"A1","D1"));

sleep(10);

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>excelfile.set_sheet_name</font><hr>");

			excel.kill();
			var path = "test/test.xlsx";
			excel.open(path,false,true);

			// 1
			echo("\n1. Соединить ячейки  : ");
			echo(excel.merge_cells(path,0,"A1","D1"));

			sleep(10);

			// 2
			echo("\n2. Разъединить ячейки  : ");
			echo(excel.unmerge_cells(path,0,"A1","D1"));

			sleep(10);

			excel.close(path);

			// конец
			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_cell</font><hr>");

excel.kill();
var path = "test/test.xlsx";
excel.open(path,false,true);
app.sleep(2);

// 1
echo("1. Объединить ячейки  : ");
echo(excel.merge_cells(path,0,"A2","D2"));

app.sleep(10);

// 2
echo("\n2. Разъединить ячейки  : ");
echo(excel.unmerge_cells(path,0,"A2","D2"));

app.sleep(10);

excel.close(path);

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

// Quit
app.quit();

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

Интерфейс

merge_cells

Функционал