excelfile/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:5002";
 
// ПРИМЕР 1
// подключим объект для управления эмулятором, если еще не подключен
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($excelfile->clear_cell("test\\test.xlsx",0,1,"A"));
 
// посмотрим
$app->shell_execute("open","test\\test.xlsx");
 
// конец
echo "<hr><br>";
 
// Quit
$app->quit();
?>

<?php $xhe_host = "127.0.0.1:5002";
 
// ПРИМЕР 2
// подключим объект для управления эмулятором, если еще не подключен
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($excelfile->clear_cell("test\\test.xlsx",0,1,"1-3;4;5"));
 
// посмотрим
$app->shell_execute("open","test\\test.xlsx");
 
// конец
echo "<hr><br>";
 
// Quit
$app->quit();
?>