Установить формат Версия 9 (Net)
Группа действий: Excel
Описание
Действие устанавливает формат ячеек из указанного диапазона.
Иконка
Параметры
Входные параметры
Контекст Контекст действия для работы с Excel-документом
Имя столбца начальной ячейки Имя столбца начальной ячейки диапазона.
Индекс столбца начальной ячейки Индекс столбца начальной ячейки (начало диапазона), от которой будет установлена область.
Строка начальной ячейки Строка начальной ячейки диапазона.
Имя столбца конечной ячейки Имя столбца конечной ячейки диапазона.
Индекс столбца конечной ячейки Индекс столбца конечной ячейки диапазона.
Строка конечной ячейки Строка конечной ячейки диапазона.
Формат Формат, который будет установлен в выбранных ячейках
Маска формата Маска для создания настраиваемого формата.
Настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | ||||
Контекст | Контекст действия для работы с Excel-документом | Robin.Excel | Контекст excel | Да |
Имя столбца начальной ячейки | Имя столбца начальной ячейки диапазона. Если поле не заполнено, то берется значение из поля «Индекс столбца начальной ячейки». | Robin.String | Нет | |
Индекс столбца начальной ячейки | Индекс столбца начальной ячейки (начало диапазона), от которой будет установлена область. Если поле не заполнено, то берется граница используемой области. | Robin.Numeric | Нет | |
Строка начальной ячейки | Строка начальной ячейки диапазона. Если поле не заполнено, то берется граница используемой области. | Robin.Numeric | Нет | |
Имя столбца конечной ячейки | Имя столбца конечной ячейки диапазона. Если поле не заполнено, то берется значение из поля «Индекс столбца конечной ячейки». | Robin.String | Нет | |
Индекс столбца конечной ячейки | Индекс столбца конечной ячейки диапазона. Если поле не заполнено, то берется граница используемой области. | Robin.Numeric | Нет | |
Строка конечной ячейки | Строка конечной ячейки диапазона. Если поле не заполнено, то берется граница используемой области. Если адрес конечной ячейки будет меньше адреса начальной ячейки, то будет использована область которая ограничивается этими ячейками. Если адрес конечной ячейки будет меньше адреса начальной ячейки, то будет использована область которая ограничивается этими ячейками. | Robin.Numeric | Нет | |
Формат | Формат, который будет установлен в выбранных ячейках | Robin.String | Да | |
Маска формата | Маска для создания настраиваемого формата. Правила для масок пользовательского формата: 1) Любой пользовательский текст (кг, чел, шт и тому подобные) или символы (в том числе и пробелы) - надо обязательно заключать в кавычки. 2) Можно указать несколько (до 4-х) разных масок форматов через точку с запятой. Тогда первая из масок будет применяться к ячейке, если число в ней положительное, вторая - если отрицательное, третья - если содержимое ячейки равно нулю и четвертая - если в ячейке не число, а текст. 3) 0 (ноль) - одно обязательное знакоместо (разряд), т.е. это место в маске формата будет заполнено цифрой из числа, которое пользователь введет в ячейку. Если для этого знакоместа нет числа, то будет выведен ноль. Например, если к числу 12 применить маску 0000, то получится 0012, а если к числу 1,3456 применить маску 0,00 - получится 1,35. 4) # (решетка) - одно необязательное знакоместо - примерно то же самое, что и ноль, но если для знакоместа нет числа, то ничего не выводится 5) (пробел) - используется как разделитель групп разрядов по три между тысячами, миллионами, миллиардами и т.д. 6) [ ] - в квадратных скобках перед маской формата можно указать цвет шрифта. Разрешено использовать следующие цвета: черный, белый, красный, синий, зеленый, жёлтый, голубой. | Robin.String | Нет |
Особые условия использования
Если адрес "До" будет меньше адреса "От", будет использована область которая ограничивается этими ячейками.
Правила для масок пользовательского формата:
- Любой пользовательский текст (кг, чел, шт и тому подобные) или символы (в том числе и пробелы) - надо обязательно заключать в кавычки.
- Можно указать несколько (до 4-х) разных масок форматов через точку с запятой. Тогда первая из масок будет применяться к ячейке, если число в ней положительное, вторая - если отрицательное, третья - если содержимое ячейки равно нулю и четвертая - если в ячейке не число, а текст.
- 0 (ноль) - одно обязательное знакоместо (разряд), т.е. это место в маске формата будет заполнено цифрой из числа, которое пользователь введет в ячейку. Если для этого знакоместа нет числа, то будет выведен ноль. Например, если к числу 12 применить маску 0000, то получится 0012, а если к числу 1,3456 применить маску 0,00 - получится 1,35.
- # (решетка) - одно необязательное знакоместо - примерно то же самое, что и ноль, но если для знакоместа нет числа, то ничего не выводится
- (пробел) - используется как разделитель групп разрядов по три между тысячами, миллионами, миллиардами и т.д.
- [ ] - в квадратных скобках перед маской формата можно указать цвет шрифта. Разрешено использовать следующие цвета: черный, белый, красный, синий, зеленый, жёлтый, голубой.
Пример использования
Задача
Существует Excel-документ с таблицей:
Необходимо поменять формат ячеек в столбце B (с В2 по В7) с общего на денежный.
Решение
Воспользоваться действиями "Открыть", "Установить формат", "Сохранить".
Реализация
- Собрать схему робота, состоящую из действий:
- Настроить параметры для действия "Открыть". В поле "Путь к файлу" указать путь до требуемого Excel-файла. Проставить чекбокс Видимый = true для отображения действий робота на экране.
- Настроить параметры для действия "Сохранить". В параметре "Контекст" указать контекст Excel-документа.
- Запустить робота по кнопке "Старт" в верхней панели.
Результат
Программный робот отработал успешно.
В требуемом диапазоне изменен формат ячеек с общего на денежный.