set_range_border

set_range_border(string path, int sheet, string range, string color, int border_type=13, string aligment='all')

Данная команда позволяет задать тип и цвет границы ячеек указанного диапазона.

Команда на вход принимает параметры:
  • path – путь к файлу Excel;
  • sheet – номер листа;
  • range – адрес диапазона ячеек. Например: "E1:E5";
  • color – цвет HTML (HTML Color. Например: "#FF0000");
  • border_type – стиль границы диапазона ячеек.
    Данный параметр может принимать значения в числовом диапазоне от 0 до 13:
    0: BORDER_DASHDOT (тире точка)
    1: BORDER_DASHDOTDOT (тире точка точка)
    2: BORDER_DASHED (пунктирный через тире)
    3: BORDER_DOTTED (пунктирный через точку)
    4: BORDER_DOUBLE (двойной)
    5: BORDER_HAIR (тонкий)
    6: BORDER_MEDIUM (средней толщины)
    7: BORDER_MEDIUMDASHDOT (средний тире точка)
    8: BORDER_MEDIUMDASHDOTDOT (средний тире точка точка)
    9: BORDER_MEDIUMDASHED (пунктирный средней толщины)
    10: BORDER_NONE (нет границ)
    11: BORDER_SLANTDASHDOT (наклонная точка)
    12: BORDER_THICK (толстая)
    13: BORDER_THIN (тонкая. Значение по умолчанию.)
  • alignment – к какой границе (к каким границам) ячейки применить результат данной команды. Может принимать следующие значения:
    left: к левой границе ячейки
    right: к правой границе ячейки
    top: к верхней границе ячейки
    bottom: к нижней границе ячейки
    all: ко всем границам ячейки. Значение по умолчанию.
После отработки команда возвращает результат своей работы в робот:
  • true/false - выполнено успешно? Да/Нет (type: bool).



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

<?php $xhe_host = "127.0.0.1:7021";
 
// подключим функциональные объекты
if (!isset($path))
  $path = "../../../Templates/init.php";
require($path);
 
// начало
echo "<hr><font color=blue>excelfile->".basename (__FILE__)."</font><hr>";
 
$excel->kill();
 
// 1
echo("\n1. Зададим цвет и тип границ диапазона: ");
echo($excelfile->set_range_border("test\\test.xlsx", 0, "E1:E5", "FFFF00", 2));
 
// посмотрим
$app->shell_execute("open", "test\\test.xlsx");
 
// конец
echo "<hr><br>";
 
// Quit
$app->quit();
?>