set_range_format

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

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

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

Переменная format поддерживает числовые форматы MS Excel, например:
    • 'General', 
    • '0', '0.00',
    •  '#,##0',
    •  '#,##0.00', 
    • '0%', 
    • '0.00%';
    А также:
  • Экспоненциальные форматы разной точности:
    • '##0.0E+0'
    • '0.00E+00';
  • Дробные форматы:
    • '# ?/?',
    • '# ??/??';
  • Денежные с красной подсветкой отрицательного значения или без:
    • '#,##0 ;(#,##0)',
    • '#,##0 ;[Red](#,##0)',
    • '#,##0.00;(#,##0.00)',
    • '#,##0.00;[Red](#,##0.00)'.

Примечание: В версии 7.0.74.17 команда была переименована с set_range_number_format на set_range_format, но старый вызов тоже работает.


После отработки команда возвращает результат своей работы в робот
  • 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();
?>

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

xhe_host="127.0.0.1:7027";
echo=require("../../../Templates JS/init.js");
 
// начало
echo("<hr><font color=blue>excelfile.get_cell</font><hr>");
 
excel.kill();
 
// 1
echo("1. Зададим формат диапазона (встроенный): ");
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();

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

# Additional paths
import sys
sys.path.insert(0, '../../../Templates PY/')
 
xhe_host = "127.0.0.1:7027"
from xweb_human_emulator import *
 
# начало
echo("<hr><font color=blue>excelfile.set_cell</font><hr>")
 
excel.kill();
 
# 1
echo("1. Зададим формат диапазона (встроенный): ");
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()