История страницы
...
Insert image Version 1 (Net)
Группа действийAction group: Word
Описание
Действие вставляет изображение в указанное место Word-документа.
Указывается Word-документ, изображение для вставки и место его добавления. Также по желанию можно указать размер изображения и возможность добавления его с новой строки.
Иконка
Параметры
Входные параметры
- Контекст - контекст открытого Word-документа. Открыть Word-документ можно с помощью с действия "Открыть" (группа "Word").
- Изображение - путь к файлу изображения, которое необходимо вставить в документ.
- Высота - высота в пикселях, на которое изменится указанное изображение. Параметр учитывается только, если заполнен параметр "Ширина". Иначе изображение останется в исходном размере.
- Ширина - ширина в пикселях, на которое изменится указанное изображение. Параметр учитывается только, если заполнен параметр "Высота". Иначе изображение останется в исходном размере.
- Место добавления - место в документе, куда необходимо вставить изображение. Доступно 3 варианта: Начало документа, Конец документа, После закладки.
- Название закладки - название закладки, после которой будет вставлено изображение. Параметр учитывается только, если заполнен параметр "Место добавления" - После закладки.
- С новой строки - параметр, с помощью которого указанное изображение вставляется с новой строки. Последующий текст после изображения также переносится на новую строку. Примеры с выключенным и включенным параметром соответственно:
Параметр "С новой строки" выключен:
Параметр "С новой строки" включен:
Настройки
...
Description
The action inserts an image at the specified location in a Word-document.
You specify a Word-document, an image for insertion, and location where to add it. You can also optionally specify the size of the image and the possibility of adding it from a new line.
Action icon
Settings of parameters
Property | Description | Type | Filling example | Mandatory field |
Parameters | ||||
Context | The Word document instance to which the action will be applied |
Свойство
Описание
Тип
Пример заполнения
Обязательность заполнения поля
Параметры
Контекст
. | Robin.Word |
Word |
context |
Yes |
Изображение
Image | The path to the image file to be inserted into the Word document. | Robin.FilePath |
Да
Yes | ||
Height | The height in pixels that will be set to the specified image when pasted. Not taken into account if «Width» is not filled. | Robin.Numeric |
No |
Width | The width in pixels that will be set to the specified image when inserted. It is not taken into account if the «Height» is not filled in |
. | Robin.Numeric |
No |
Место в документе, куда будет вставлено изображение.
Выпадающий список с элементами:
- Начало документа
- Конец документа
- После закладки
Place of addition | The location in the document where the image will be inserted. | Robin.String |
Yes |
Bookmark name | The name of the bookmark after which the table will be inserted. | Robin.String |
No |
A new line | If the value is «true», then the image will be inserted on a new line. Subsequent text in the document will also wrap to a new line. | Robin.Boolean | true |
Особые условия использования
No |
Special conditions of use
The markup option for the inserted image is "In textПараметр разметки вставленного изображения -"В тексте":
Если выбрано место добавления после закладки, то необходимо указать имя закладки. Иначе робот выдаст ошибку.
Если указано в параметрах указано и имя закладки и место добавления, но место добавления отличное от "после закладки" , то действие будет игнорировать параметр имени закладки.
Если выбрано место добавления после закладки, но в документе отсутствуют какие-либо закладки, то робот выдаст ошибку.
Если один из параметров высоты или ширины не будет заполнен, то изображение вставится в документ в своем размере.
Действие не работает с заблокированными полями в защищенных документах. В этом случае робот выдаст ошибку.
Подробнее о закладках в Word: Закладки в Word
Пример использования
Задача
имеется Word-документ. Необходимо вставить изображение после закладки.
Документ:
Решение
Воспользоваться действиями "Открыть", "Вставить изображение", "Сохранить как", "Закрыть".
Реализация
- Собрать схему робота, состоящую из действий:
- Настроить параметры действия "Открыть". В поле "Путь к файлу" указать путь к файлу Word-документа. В поле "Видимый" проставить чекбокс = true.
- Настроить параметры действия "Вставить изображение". В поле "Контекст" указать экземпляр Word-документа, в котором необходимо вставить изображение. В поле "Изображение" указать путь к изображению для вставки. В полях "Высота" и "Ширина" указать необходимый размер изображения. В поле "Место добавления" указать "После закладки". В поле "Название закладки" указать имя существующей закладки после которой будет вставлено изображение. В поле "С новой строки" указать чекбокс = true.
- Настроить параметры действия "Сохранить как" В поле "Контекст" указать экземпляр Word-документа, который нужно сохранить.
- Настроить параметры действия "Закрыть". В поле "Контекст" указать экземпляр Word-документа, который нужно закрыть.
- Запустить робота по кнопке "Старт" в верхней панели.
Результат
Программный робот отработал успешно. Изображение вставилось в указанное место.
If the place of adding after the bookmark is selected, it is necessary to specify the name of the bookmark. Otherwise, the robot will return an error.
If both bookmark name and place of addition are specified in the parameters, but the place of addition is different from "after the bookmark" then the action will ignore the bookmark name parameter.
If you select the location to add after the bookmark, but there are no bookmarks in the document, the robot will return an error.
If one of the height or width parameters is not filled in, the image will be inserted into the document at its own size.
The action does not work with locked fields in protected documents. In this case the robot will return an error.
More about bookmarks in Word: Bookmarks in Word
Example of use
Task
There is a Word-document. Insert and image after the bookmark.
The document:
Solution
Use the "Open", "Insert image", "Save as", "Close document" actions.
Implementation
- Assemble a robot scheme with the actions.
- Set the "Open document" action parameters. In the "Path to file" field specify the path to the Word-document file. In the "Visible" field check the checkbox = true.
- Set the "Insert image" action parameters. In the "Context" field, specify the Word-document instance in which you want to insert the image. In the "Image" field, specify the path to the image to be inserted. In the "Height" and "Width" fields, specify the required image size. In the "Place to add" field specify "After bookmark". In the "Bookmark name" field specify the name of the existing bookmark after which the image will be inserted. In the "A new line" field check the checkbox = true.
- Set the "Save as" action parameters. In the "Context" field specify the Word-document instance to be saved.
- Set the "Close document" action parameters. In the "Context" field specify the Word-document instance to be closed.
- Click "Start" in the top panel to start the robot.
Result
The program robot completed successfully. The image was inserted at the specified location.
Word-documentWord-документ: