Установить формат диапазона / Set range format
Группа действий: Excel
Задает формат ячейкам указанного диапазона.
Название действия в репозитории - RangeSetFormat.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|---|
Параметры | |||||
Контекст | Context | Уникальный идентификатор сеанса, к которому будет применено действие | Идентификатор контекста Excel | EXCEL_INSTANCE | Да |
От | Start cell | Адрес начальной ячейки диапазона. Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки. Если поле не заполнено, то берется граница используемой области. | Строка | A1 | Нет |
До | End cell | Адрес конечной ячейки диапазона. Заполнять в формате "ХY", где "Х" - это номер столбца, а "Y" - номер строки. Если поле не заполнено, то берется граница используемой области. | Строка | A1000 | Нет |
Формат | Format | Формат, который будет установлен в выбранных ячейках. Выпадающий список допустимых форматов:
| Строка | Текстовый | Да |
Маска формата | Format template | Маска для создания настраиваемого формата. Поле становится активным после выбора значения "Пользовательский" в параметре "Формат" (решение на уровне студии). | Строка | # ##0,00 | Нет |
Особые условия использования
Если адрес "До" будет меньше адреса "От", будет использована область которая ограничивается этими ячейками.
Правила для масок пользовательского формата:
- Любой пользовательский текст (кг, чел, шт и тому подобные) или символы (в том числе и пробелы) - надо обязательно заключать в кавычки.
- Можно указать несколько (до 4-х) разных масок форматов через точку с запятой. Тогда первая из масок будет применяться к ячейке, если число в ней положительное, вторая - если отрицательное, третья - если содержимое ячейки равно нулю и четвертая - если в ячейке не число, а текст.
- 0 (ноль) - одно обязательное знакоместо (разряд), т.е. это место в маске формата будет заполнено цифрой из числа, которое пользователь введет в ячейку. Если для этого знакоместа нет числа, то будет выведен ноль. Например, если к числу 12 применить маску 0000, то получится 0012, а если к числу 1,3456 применить маску 0,00 - получится 1,35.
- # (решетка) - одно необязательное знакоместо - примерно то же самое, что и ноль, но если для знакоместа нет числа, то ничего не выводится
- (пробел) - используется как разделитель групп разрядов по три между тысячами, миллионами, миллиардами и т.д.
- [ ] - в квадратных скобках перед маской формата можно указать цвет шрифта. Разрешено использовать следующие цвета: черный, белый, красный, синий, зеленый, жёлтый, голубой.