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