Форматировать текст / Format text

Группа действий: Word

Описание

Действие форматирует указанный текст.

Указывается Word-документ, название закладки, относительно которой будет форматироваться текст, и параметры форматирования.

Иконка

Параметры

Входные параметры:

Контекст - контекст открытого Word-документа. Открыть Word-документ можно с помощью с действия "Открыть" (группа "Word").
Название закладки - название закладки, с которой будет изменен текст. Будет изменен весь текст от закладки и до конца документа или до начала следующей закладки при ее наличии. Если в закладке указан точный отрывок текста, к которому она относится, то изменен будет только этот текст. Можно указать сразу несколько закладок, указав каждое название через ";". Если закладка не будет указана, то форматирование применится ко всему документу.
Убрать форматирование - параметр, с помощью которого можно привести текст к классическому формату: черный цвет текста без курсива, полужирности, подчеркивания и выделения.
Полужирный - выделение текста полужирным шрифтом.
Курсив - выделение текста курсивом.
Подчеркнутый - выделение текста подчеркиванием.
Размер текста - установка размера шрифта текста. Диапазон возможного размера от 1 до 1638. Размер должен быть кратен 0.5.
Цвет текста - установка цвета шрифта текста. Доступно 11 вариантов: Темно-красный, Красный, Оранжевый, Желтый, Светло-зеленый, Зеленый, Голубой, Синий, Темно-синий, Сиреневый, Черный.
Цвет выделения текста - установка выделения текста. Доступно 16 вариантов: Нет цвета, Желтый, Зеленый, Бирюзовый, Розовый, Синий, Красный, Темно-синий, Сине-зеленый, Зеленый, Фиолетовый, Бордовый, Коричнево-зеленый, Серый, Светло-серый, Черный.

Настройки

Свойство	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Контекст	Экземпляр Word-документа, к которому будет применено действие.	Robin.Word	Контекст Word-документа	Да
Название закладки	Название закладки, указывающей начало форматирования. Будет изменен весь текст от закладки и до конца документа или до начала следующей закладки при ее наличии. Если в закладке указан точный отрывок текста, к которому она относится, то изменен будет только этот текст. Можно указать сразу несколько закладок, указав каждое название через ";". Если закладка не будет указана, то форматирование применится ко всему документу.	Robin.String	Закладка1;Закладка2	Нет
Убрать форматирование	Если значение "true", то с указанного текста снимается форматирование. Цвет текста станет черным, снимется выделение, курсив, полужирность и подчеркивание.	Robin.Boolean	true	Нет
Полужирный	Если значение "true", то шрифт текста станет полужирным.	Robin.Boolean	true	Нет
Курсив	Если значение "true", то шрифт текста станет курсивным.	Robin.Boolean	true	Нет
Подчеркнутый	Если значение "true", то указанный текст подчеркивается.	Robin.Boolean	true	Нет
Размер текста	Размер шрифта текста, который будет установлен для указанного текста. Размер может быть в диапазоне от 1 до 1638 и кратен 0.5.	Robin.Numeric	12,5	Нет
Цвет текста	Цвет шрифта текста, который будет установлен для указанного текста. Элементы выпадающего списка: Темно-красный Красный Оранжевый Желтый Светло-зеленый Зеленый Голубой Синий Темно-синий Сиреневый Черный	Robin.String	Красный	Нет
Цвет выделения текста	Цвет выделения, которое будет установлено в указанном тексте. Если выбрано "Нет цвета", то выделение текста будет убрано. Элементы выпадающего списка: Нет цвета Желтый Зеленый Бирюзовый Розовый Синий Красный Темно-синий Сине-зеленый Зеленый Фиолетовый Бордовый Коричнево-зеленый Серый Светло-серый Черный	Robin.String	Желтый	Нет

Особые условия использования

Если указано имя несуществующей закладки, то робот выдаст ошибку.

Подробнее о закладках в Word: Закладки в Word

Если указан текст, но не указан ни один параметр форматирования, действие ничего не меняет.

Если указаны параметры форматирования, которые уже есть в тексте, то действие ничего не изменит.

Если выбран элемент форматирования, а также уборка форматирования, робот выдаст ошибку.

Если в параметре размера шрифта будет указано число не входящее в диапазон, робот выдаст ошибку.

Действие не работает с заблокированными полями в защищенных документах. В этом случае робот бросит ошибку.

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

Задача: имеется Word-документ. Необходимо задать новое форматированию тексту всего документа.

Документ:

Решение: воспользоваться действиями "Открыть", "Форматировать текст", "Сохранить как", "Закрыть".

Реализация:

Собрать схему робота, состоящую из действий:
Настроить параметры действия "Открыть". В поле "Путь к файлу" указать путь к файлу Word-документа. В поле "Видимый" проставить чекбокс = true.
Настроить параметры действия "Форматировать текст". В поле "Контекст" указать экземпляр Word-документа, в котором необходимо форматировать текст. В поле "Полужирный" указать чекбокс = true. В поле "Курсив" указать чекбокс = true. В поле "Подчеркнутый" указать чекбокс = true. В поле "Размер текста" указать "15". В поле "Цвет текста" указать "Зеленый". В поле "Цвет выделения текста" указать "Желтый".
Настроить параметры действия "Сохранить как". В поле "Контекст" указать экземпляр Word-документа, который нужно сохранить.
Настроить параметры действия "Закрыть". В поле "Контекст" указать экземпляр Word-документа, который нужно закрыть.
Запустить робота по кнопке "Старт" в верхней панели.