Установить формат диапазона / Set range format
Группа действий: Excel
Задает формат ячейкам указанного диапазона.
Настройки
Свойство | Англ. наименование | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
|---|---|---|---|---|---|
| Параметры | |||||
| Контекст | Context | Контекст действия для работы с Excel-документом | Идентификатор контекста Excel | EXCEL_INSTANCE | Да |
| Столбец начальной ячейки | Start cell column | Столбец начальной ячейки диапазона. Если поле не заполнено, то берется граница используемой области. | Строка | Нет | |
| Строка начальной ячейки | Start Cell Row | Строка начальной ячейки диапазона. Если поле не заполнено, то берется граница используемой области. | Число | Нет | |
| Столбец конечной ячейки | Destination cell column | Столбец конечной ячейки диапазона. Если поле не заполнено, то берется граница используемой области. Если адрес конечной ячейки будет меньше адреса начальной ячейки, то будет использована область которая ограничивается этими ячейками. Если адрес конечной ячейки будет меньше адреса начальной ячейки, то будет использована область которая ограничивается этими ячейками. | Строка | Нет | |
| Строка конечной ячейки | Destination cell string | Строка конечной ячейки диапазона. Если поле не заполнено, то берется граница используемой области. Если адрес конечной ячейки будет меньше адреса начальной ячейки, то будет использована область которая ограничивается этими ячейками. Если адрес конечной ячейки будет меньше адреса начальной ячейки, то будет использована область которая ограничивается этими ячейками. | Число | Нет | |
| Формат | Format | Формат, который будет установлен в выбранных ячейках | Строка | Да | |
| Маска формата | Format mask | Маска для создания настраиваемого формата. Правила для масок пользовательского формата: 1) Любой пользовательский текст (кг, чел, шт и тому подобные) или символы (в том числе и пробелы) - надо обязательно заключать в кавычки. 2) Можно указать несколько (до 4-х) разных масок форматов через точку с запятой. Тогда первая из масок будет применяться к ячейке, если число в ней положительное, вторая - если отрицательное, третья - если содержимое ячейки равно нулю и четвертая - если в ячейке не число, а текст. 3) 0 (ноль) - одно обязательное знакоместо (разряд), т.е. это место в маске формата будет заполнено цифрой из числа, которое пользователь введет в ячейку. Если для этого знакоместа нет числа, то будет выведен ноль. Например, если к числу 12 применить маску 0000, то получится 0012, а если к числу 1,3456 применить маску 0,00 - получится 1,35. 4) # (решетка) - одно необязательное знакоместо - примерно то же самое, что и ноль, но если для знакоместа нет числа, то ничего не выводится 5) (пробел) - используется как разделитель групп разрядов по три между тысячами, миллионами, миллиардами и т.д. 6) [ ] - в квадратных скобках перед маской формата можно указать цвет шрифта. Разрешено использовать следующие цвета: черный, белый, красный, синий, зеленый, жёлтый, голубой. | Строка | Нет | |
Особые условия использования
Если адрес "До" будет меньше адреса "От", будет использована область которая ограничивается этими ячейками.
Правила для масок пользовательского формата:
- Любой пользовательский текст (кг, чел, шт и тому подобные) или символы (в том числе и пробелы) - надо обязательно заключать в кавычки.
- Можно указать несколько (до 4-х) разных масок форматов через точку с запятой. Тогда первая из масок будет применяться к ячейке, если число в ней положительное, вторая - если отрицательное, третья - если содержимое ячейки равно нулю и четвертая - если в ячейке не число, а текст.
- 0 (ноль) - одно обязательное знакоместо (разряд), т.е. это место в маске формата будет заполнено цифрой из числа, которое пользователь введет в ячейку. Если для этого знакоместа нет числа, то будет выведен ноль. Например, если к числу 12 применить маску 0000, то получится 0012, а если к числу 1,3456 применить маску 0,00 - получится 1,35.
- # (решетка) - одно необязательное знакоместо - примерно то же самое, что и ноль, но если для знакоместа нет числа, то ничего не выводится
- (пробел) - используется как разделитель групп разрядов по три между тысячами, миллионами, миллиардами и т.д.
- [ ] - в квадратных скобках перед маской формата можно указать цвет шрифта. Разрешено использовать следующие цвета: черный, белый, красный, синий, зеленый, жёлтый, голубой.
Пример использования
Задача: существует Excel-документ с таблицей 
. Необходимо поменять формат ячеек в столбце B (с В2 по В7) с общего на денежный.
Решение: воспользоваться действиями "Открыть", "Установить формат", "Сохранить".
Реализация:
- Перетащить на рабочую область действие "Открыть" и настроить его параметры. В поле "Путь к файлу" указать путь до требуемого Excel-файла. Проставить чекбокс Видимый = true для отображения действий робота на экране.
- Перетащить на рабочую область действие "Сохранить". В параметре "Контекст" указать контекст Excel-документа.
- Запустить робота по кнопке "Старт" в верхней панели.
Результат:
Программный робот отработал успешно.
В требуемом диапазоне изменен формат ячеек с общего на денежный.
Обзор
Инструменты контента