История страницы
...
Set range format Version 9 (Net)
Группа действийAction group: Excel
Описание
Действие устанавливает формат ячеек из указанного диапазона.
Иконка
Параметры
Входные параметры
Контекст Контекст действия для работы с Excel-документом
Имя столбца начальной ячейки Имя столбца начальной ячейки диапазона.
...
Строка начальной ячейки Строка начальной ячейки диапазона.
Имя столбца конечной ячейки Имя столбца конечной ячейки диапазона.
Индекс столбца конечной ячейки Индекс столбца конечной ячейки диапазона.
Строка конечной ячейки Строка конечной ячейки диапазона.
Формат Формат, который будет установлен в выбранных ячейках
Маска формата Маска для создания настраиваемого формата.
Настройки
...
Свойство
...
Описание
...
Тип
...
Пример заполнения
...
Обязательность заполнения поля
...
Параметры
...
Контекст
...
Контекст действия для работы с Excel-документом
...
Robin.Excel
...
Контекст excel
...
Да
...
Имя столбца начальной ячейки
...
Имя столбца начальной ячейки диапазона. Если поле не заполнено, то берется значение из поля «Индекс столбца начальной ячейки».
...
Robin.String
...
Нет
...
Индекс столбца начальной ячейки
...
Индекс столбца начальной ячейки (начало диапазона), от которой будет установлена область. Если поле не заполнено, то берется граница используемой области.
...
Robin.Numeric
...
Нет
...
Строка начальной ячейки
...
Строка начальной ячейки диапазона. Если поле не заполнено, то берется граница используемой области.
...
Robin.Numeric
...
Нет
...
Имя столбца конечной ячейки
...
Имя столбца конечной ячейки диапазона. Если поле не заполнено, то берется значение из поля «Индекс столбца конечной ячейки».
...
Robin.String
...
Нет
...
Индекс столбца конечной ячейки
...
Индекс столбца конечной ячейки диапазона. Если поле не заполнено, то берется граница используемой области.
...
Robin.Numeric
...
Нет
...
Строка конечной ячейки
...
Строка конечной ячейки диапазона. Если поле не заполнено, то берется граница используемой области. Если адрес конечной ячейки будет меньше адреса начальной ячейки, то будет использована область которая ограничивается этими ячейками. Если адрес конечной ячейки будет меньше адреса начальной ячейки, то будет использована область которая ограничивается этими ячейками.
...
Robin.Numeric
...
Нет
...
Формат
...
Формат, который будет установлен в выбранных ячейках
...
Robin.String
...
Да
...
Маска формата
...
Description
The action sets the format of cells from the specified range.
Icon
Settings of parameters
Property | Description | Type | Example of filling in | Obligatory to fill in the field |
Parameters | ||||
| Context | Action context for working with an Excel document | Excel instance | Excel context | Yes |
| Start cell column name | The column name of the start cell of the range. If the field is not filled in, the value from the "Start cell column index" field is taken. | String | No | |
| Start cell column index | Column index of the start cell (beginning of the range) from which the area will be set. If the field is not filled in, the boundary of the used area is taken. | Numeric | No | |
| Start cell row | Row of the start cell of the range. If the field is not filled in, the boundary of the used area is taken. | Numeric | No | |
| End cell column name | The name of the end cell column of the range. If the field is not filled in, the value from the "End cell column index" field is taken. | String | No | |
| End cell column index | The column index of the end cell of the range. If the field is not filled in, the boundary of the used area is taken. | Numeric | No | |
| End cell row | The area to be used is taken. If the address of the end cell is less than the address of the start cell, the area that is bounded by these cells will be used. If the address of the end cell is less than the address of the start cell, the area that is limited to these cells will be used. | Numeric | No | |
| Format | The format to be set in the selected cells. | String | Yes | |
| Format mask | Mask for creating a custom format. Rules for custom format masks: 1) Any custom text (kg, per, pcs, etc.) or characters (including spaces) must be enclosed in quotes. 2) You can specify several (up to 4) different format masks using semicolons. Then the first of the masks will be applied to the cell if the number in the cell is positive, the second - if it is negative, the third - if the cell content is zero and the fourth - if the cell is not a number but text. 3) 0 (zero) - one mandatory placeholder (digit), i.e. this place in the format mask will be filled with a digit from the number that the user will enter into the cell. If there is No number for this character space, zero will be output. For example, if the mask 0000 is applied to the number 12, 0012 will be output, and if the mask 0.00 is applied to the number 1.3456, 1.35 will be output. 4) # (lattice) - one optional character - roughly the same as zero, but if there is a No number for the character, nothing is outputted. 5) (space) - used as a separator of groups of digits of three between thousands, millions, billions, etc. 6) [ ] - you can specify the font color in square brackets before the format mask. The following colors are allowed: black, white, red, blue, green, yellow, light blue. | String | No | |
Special conditions for use
If the "To" address is smaller than the "From" address, the area that is limited to these cells will be used.
Rules for custom format masks:
- Any custom text (kg, per, pc, etc.) or symbols (including spaces) must be enclosed in quotation marks.
- You can specify several (up to 4) different format masks using semicolons. Then the first of the masks will be applied to the cell if the number in the cell is positive, the second if it is negative, the third if the cell content is zero, and the fourth if the cell contains text instead of a number.
- 0 (zero) - one mandatory placeholder (digit), i.e. this place in the format mask will be filled with a digit from the number that the user will enter into the cell. If there is No number for this character space, zero will be output. For example, if the mask 0000 is applied to the number 12, 0012 will be output, and if the mask 0.00 is applied to the number 1.3456, 1.35 will be output.
- # (lattice) - one optional character - roughly the same as zero, but if there is a No number for the character, nothing is output.
- (space) - used as a separator of groups of digits of three between thousands, millions, billions, etc.
- [ ] - you can specify the font color in square brackets before the format mask. The following colors are allowed: black, white, red, blue, green, yellow, cyan.
Example of use
Task
There is an Excel document with a table:
You need to change the format of cells in column B (from B2 to B7) from general to currency.
Solution
Use the actions "Open", "Set range format", "Save".
Implementation
- Assemble a robot scheme consisting of actions:
- Configure parameters for the "Open" action. In the "Path to file" field, specify the path to the required Excel file. Check the Visible = true checkbox to display robot actions on the screen.
- Set parameters for the "Set format" action. Fill in the "Context" field, specifying the context of the opened document.
Fill in the fields associated with columns and rows according to the range from B2 to B7, select "Currency" in the "Format" field.
- Customize parameters for the "Save" action. Specify the context of the Excel document in the "Context" parameter.
- Launch the robot using the "Start" button in the top panel.
Result
The program robot completed successfully.
In the required range, changed the cell format from general to currency.
...
Маска для создания настраиваемого формата. Правила для масок пользовательского формата: 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) с общего на денежный.
Решение
Воспользоваться действиями "Открыть", "Установить формат", "Сохранить".
Реализация
...
Результат
Программный робот отработал успешно.
В требуемом диапазоне изменен формат ячеек с общего на денежный.
Обзор
Инструменты контента