История страницы
Вставить изображение / Insert image
Группа действий: Word
Описание
Действие вставляет изображение в указанное место Word-документа.
Указывается Word-документ, изображение для вставки и место его добавления. Также по желанию можно указать размер изображения и возможность добавления его с новой строки.
Параметры
Входные параметры:
- Контекст - контекст открытого Word-документа. Открыть Word-документ можно с помощью с действия "Открыть" (группа "Word").
- Изображения - путь к файлу изображения, которое необходимо вставить в документ.
- Высота - высота в пикселях, на которое изменится указанное изображение. Параметр учитывается только если заполнен параметр "Ширина". Иначе изображение останется в исходном размере.
- Ширина - ширина в пикселях, на которое изменится указанное изображение. Параметр учитывается только если заполнен параметр "Высота". Иначе изображение останется в исходном размере.
- Место добавления - место в документе, куда необходимо вставить изображение. Доступно 3 варианта: Начало документа, Конец документа, После закладки.
- Название закладки - название закладки, после которой будет вставлено изображение. Параметр учитывается только если заполнен параметр "Место добавления" - После закладки.
- С новой строки - параметр, с помощью которого указанное изображение вставляется с новой строки. Последующий текст после изображения также переносится на новую строку. Примеры с выключенным и включенным параметром соответственно:
Настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | ||||
Контекст | Экземпляр Word-документа, к которому будет применено действие. | Robin.Word | Контекст Word-документа | Да |
Изображения | Путь к файлу изображения, которое будет вставлено в Word-документ. | Robin.FilePath | C:\User\image.jpg | Да |
Высота | Высота в пикселях, которая будет установлена указанному изображению при вставке. Не учитывается, если не заполнена "Ширина". Указывается в пикселях. | Robin.Numeric | 500 | Нет |
Ширина | Ширина в пикселях, которая будет установлена указанному изображению при вставке. Не учитывается, если не заполнена "Высота". Указывается в пикселях. | Robin.Numeric | 500 | Нет |
Место добавления | Место в документе, куда будет вставлено изображение. Выпадающий список с элементами:
| Robin.String | После закладки | Да |
Название закладки | Название закладки, после которой будет вставлено изображение. | Robin.String | Закладка1 | Нет |
С новой строки | Если значение "true", то изображение будет вставлено с новой строки. Последующий текст в документе будет также перенесен на новую строку. | Robin.Boolean | true | Нет |
Особые условия использования
Параметр разметки вставленного изображения -"В тексте".
Если выбрано место добавления после закладки, то необходимо указать имя закладки. Иначе робот выдаст ошибку.
Если указано имя закладки, но выбрано другое место добавления, то действие будет игнорировать параметр имени закладки.
Если выбрано место добавления после закладки, но в документе отсутствуют какие-либо закладки, то робот выдаст ошибку.
Если один из параметров высоты или ширины не будет заполнен, то изображение вставится в документ в своем размере.
Действие не работает с заблокированными полями в защищенных документах. В этом случае робот бросит ошибку.
Пример использования
Задача: имеется Word-документ. Необходимо вставить изображение после закладки.
Документ:
Решение: воспользоваться действиями "Открыть", "Вставить изображение", "Сохранить как", "Закрыть".
Реализация:
- Перетащить на рабочую область действие "Открыть" и настроить его параметры. В поле "Путь к файлу" указать путь к файлу Word-документа. В поле "Видимый" проставить чекбокс = true.
- Перетащить на рабочую область действие "Вставить изображение" и настроить его параметры. В поле "Контекст" указать экземпляр Word-документа, в котором необходимо вставить изображение. В поле "Изображение" указать путь к изображению для вставки. В полях "Высота" и "Ширина" указать необходимый размер изображения. В поле "Место добавления" указать "После закладки". В поле "Название закладки" указать имя существующей закладки после которой будет вставлено изображение. В поле "С новой строки" указать чекбокс = true.
- Перетащить на рабочую область действие "Сохранить как" и настроить его параметры. В поле "Контекст" указать экземпляр Word-документа, который нужно сохранить.
- Перетащить на рабочую область действие "Закрыть" и настроить его параметры. В поле "Контекст" указать экземпляр Word-документа, который нужно закрыть.
- Запустить робота по кнопке "Старт" в верхней панели.
Результат:
Программный робот отработал успешно. Изображение вставилось в указанное место.
Word-документ: