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(); ?>