clear_cell

clear_cell(path, sheet, row, col)

Данная команда очищает одну или несколько произвольных ячеек в строке excel файла.

Команда на вход принимает параметры:
  • path – путь к файлу
  • sheet – номер листа
  • row – строка
  • col – столбец

Примечание: с версии 7.0.73 в команду добавлена возможность очищать несколько произвольных ячеек строки путем передачи в четвертый параметр данной команды (col) сложного значения. Например: "1-3;4;5". Где "1-3" - перечень очищаемых ячеек диапазона, "4;5" - произвольное перечисление очищаемых ячеек.


После отработки команда возвращает результат своей работы в робот:
  • true - ячейка успешно очищена (type: bool)
  • false - не удалось очистить ячейку (type: bool)



Примеры использования (php)

<?php $xhe_host = "127.0.0.1:7040";
 
// ПРИМЕР 1
// подключим объект для управления эмулятором, если еще не подключен
if (!isset($path))
  $path="../../../Templates/init.php";
require($path);
 
// начало
echo "<hr><font color=blue>excel->".basename (__FILE__)."</font><hr>";
 
$excel->kill();
 
// 1 
echo("1. Очистим ячейку: ");
echo($excel->clear_cell("test\\test.xlsx",0,6,"A"));
 
// посмотрим
$app->shell_execute("open","test\\test.xlsx");
 
// конец
echo "<hr><br>";
 
// Quit
$app->quit();
?>
<?php $xhe_host = "127.0.0.1:7040";
 
// ПРИМЕР 2
// подключим объект для управления эмулятором, если еще не подключен
if (!isset($path))
  $path="../../../Templates/init.php";
require($path);
 
// начало
echo "<hr><font color=blue>excel->".basename (__FILE__)."</font><hr>";
 
$excel->kill();
 
// 1 
echo("1. Очистим несколько произвольных ячеек строки: ");
echo($excel->clear_cell("test\\test.xlsx",0,6,"1-3;4;5"));
 
// посмотрим
$app->shell_execute("open","test\\test.xlsx");
 
// конец
echo "<hr><br>";
 
// Quit
$app->quit();
?>
<?php $xhe_host = "127.0.0.1:7040";
 
// подключим функциональные объекты, если еще не подключен
if (!isset($path))
  $path="../../../Templates/init.php";
require($path);
 
// начало
echo "<hr><font color=blue>excelfile->".basename (__FILE__)."</font><hr>";
 
$excel->kill();
 
// 1 
echo("1. Очистим ячейку : ");
echo($excel->clear_cell("test\\test.xlsx",0,6,"A"));
 
// посмотрим
$app->shell_execute("open","test\\test.xlsx");
 
// конец
echo "<hr><br>";
 
// Quit
$app->quit();
?>

Примеры использования (js)

xhe_host="127.0.0.1:7040";
echo=require("../../../Templates JS/init.js");
 
// начало
echo("<hr><font color=blue>excelfile.get_cell</font><hr>");
 
// 1 
echo("\n1. Очистим ячейку : ");
echo(excel.clear_cell("test\\test.xlsx",0,1,"A"));
 
// посмотрим
app.shell_execute("open","test\\test.xlsx");
 
// конец
echo("<hr><br>");
 
// Quit
app.quit();

Примеры использования (py)

# Additional paths
import sys
sys.path.insert(0, '../../../Templates PY/')
 
xhe_host = "127.0.0.1:7040"
from xweb_human_emulator import *
 
# начало
echo("<hr><font color=blue>excelfile.set_cell</font><hr>")
 
# 1 
echo("\n1. Очистим ячейку : ");
echo(excel.clear_cell("test\\test.xlsx",0,1,"A"));
 
# посмотрим
app.shell_execute("open","test\\test.xlsx");
 
# конец
echo("<hr><br>")
 
# Quit
app.quit()