Создать закладку Версия 1 (Net)

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

Описание

Действие создает закладку в указанном месте Word-документа

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

Иконка действия

Параметры и их настройки

Свойство

Описание

Тип

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

Обязательность заполнения поля

Параметры

Контекст

Экземпляр Word-документа, к которому будет применено действие

Robin.Word

Контекст Word-документа

Да

Название закладки

Название новой закладки. Должно начинаться с буквы, не иметь пробелов и не превышать 40 символов. Если в документе уже есть закладка с таким именем, то робот вернет ошибку

Robin.String

Закладка1

Да

Номер страницыНомер страницы Word-документа, на которой будет установлена новая закладка. Если поле не заполнено, поиск места вставки закладки будет осуществлен по всему документуRobin.Numeric1Нет
Текст

Текст в Word-документе, относительно которого будет добавлена закладка

Robin.StringКавказский пленникДа
Место добавления

Расположение закладки относительно указанного текста

Элементы выпадающего списка:

  • Перед текстом
  • После текста
  • Вставить текст в закладку
Robin.StringПеред текстомДа
Номер совпадения текстаПорядковый номер совпадения указанного текста в Word-документе. Нумерация начинается с 1. Для поиска последнего совпадения необходимо указать -1Robin.Numeric-1Да

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

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

  1. Если в документе уже есть закладка с введенным именем, то робот вернет ошибку.
  2. Если пользователь не укажет номер страницы, то поиск текста будет осуществлен по всему документу.
  3. Если пользователь укажет порядковый номер совпадения, который отсутствует в документе, то робот вернет ошибку.
  4. Если пользователь укажет порядковый номер совпадения "0" или меньше "-1", робот вернет ошибку.
  5. Если пользователь укажет текст, который отсутствует в документе, робот вернет ошибку.
  6. Если пользователь укажет несуществующий номер страницы, робот вернет ошибку.

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

Задача

Имеется Word-документ. Необходимо создать новую закладку после текста "Кавказский пленник".
Документ.

Решение

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

Реализация

  1. Собрать схему робота, состоящую из действий. 

  2. Настроить параметры действия "Открыть". В поле "Путь к файлу" указать путь к файлу Word-документа. В поле "Видимый" проставить чекбокс = true.

  3. Настроить параметры действия "Создать закладку". В поле "Контекст" указать экземпляр Word-документа, в котором необходимо создать закладку. В поле "Название закладки" указать имя новой закладки.. В поле "Текст" указать "Кавказский пленник". В поле "Место добавления" указать "После текста". В поле "Номер совпадения текста" указать "1".

  4. Настроить параметры действия "Сохранить как". В поле "Контекст" указать экземпляр Word-документа, который нужно сохранить. 

  5. Настроить параметры действия "Закрыть". В поле "Контекст" указать экземпляр Word-документа, который нужно закрыть.
  6. Запустить робота по кнопке "Старт" в верхней панели. 

Результат: 

Программный робот отработал успешно. Новая закладка создалась.

Имена закладок в Word-документе.