• EN
    RU

excelfile/set_range_number_format

set_range_number_format(path, sheet, range, format, is_predefined=true)

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

Примечание: Диапазоном (блоком, интервалом) ячеек называется прямоугольная область в таблице, которая включает несколько выделенных ячеек. Адрес диапазона обозначается именами первой и последней выделенной ячейки, которые разделяются двоеточием (например, А7:А13, В20:Р28).

Команда на вход принимает параметры:
  • path – путь к файлу
  • sheet – номер листа
  • range - диапазон ячеек
  • format - ID числового формата или строка с пользовательским форматом данных
  • is_predefined - флаг, показывающий какой числовой формат будет передаваться в предыдущем параметре предопределенный или пользовательский (по умолчанию предопределенный)
  • Примечание: Если Вы хотите использовать свой пользовательский формат - значение данному параметру присвойте false, а в предыдущем параметре (format) укажите строку с необходимым Вам форматом. Если же Вы хотите использовать один из предопределенных форматов числовых данных - оставьте данный параметр по умолчанию (true). А в предыдущем параметре (format) укажите ID одного из предопределенных форматов числовых данных: (см. таблицу)

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





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

<?php $xhe_host = "127.0.0.1:7027";
 
// подключим объект для управления эмулятором, если еще не подключен
if (!isset($path))
  $path="../../../Templates/init.php";
require($path);
 
// начало
echo "<hr><font color=blue>excelfile->".basename (__FILE__)."</font><hr>";
 
// 1
echo("\n1. Установим один из встроенных форматов диапазона ячеек: ");
echo($excelfile->set_range_number_format("test\\test.xlsx",0,"E1:E5",5,true));
 
// посмотрим
$app->shell_execute("open","test\\test.xlsx");
 
// конец
echo "<hr><br>";
 
// Quit
$app->quit();
?>
<?php $xhe_host = "127.0.0.1:7027";
 
// подключим объект для управления эмулятором, если еще не подключен
if (!isset($path))
  $path="../../../Templates/init.php";
require($path);
 
// начало
echo "<hr><font color=blue>excelfile->".basename (__FILE__)."</font><hr>";
 
// 1
echo("\n1. Установим пользовательский формат диапазона ячеек: ");
echo($excelfile->set_range_number_format("test\\test.xlsx",0,"E1:E5","yyyy/d/m/yy",false));
 
// посмотрим
$app->shell_execute("open","test\\test.xlsx");
 
// конец
echo "<hr><br>";
 
// Quit
$app->quit();
?>