192 lines
12 KiB
Markdown
192 lines
12 KiB
Markdown
# Модуль «Word»
|
||
|
||
## Основные моменты модуля
|
||
|
||
Модуль Word обеспечивает работу с документами Microsoft Word пакета
|
||
Microsoft Office. С помощью модуля можно создавать и редактировать
|
||
документы с популярными текстовыми расширениями, такими как .doc, .docx,
|
||
.html.
|
||
|
||
### Интерфейс окна
|
||
|
||
Окно модуля состоит из трех основных частей, первая – часть, содержащая
|
||
в себе поля для создания команд и кнопок управления ими, вторая –
|
||
таблица «Список команд», которая будет содержать все добавленные
|
||
действия для работы с файлом, и третья – окно с предварительным
|
||
просмотром загруженного файла.
|
||
|
||
<center><img src="../media/image163.png"/></center>
|
||
|
||
<center>Рис. 1. Интерфейс окна</center>
|
||
|
||
Окно предварительного просмотра позволяет просмотреть весь загруженный
|
||
документ в том же виде, в котором он виден в самом Microsoft Word.
|
||
|
||
Раздел настройки модуля состоит из нескольких полей, доступность которых
|
||
варьируется от необходимых для работы действий. Три первых поля являются
|
||
основными и доступными всегда, причем обязательными являются только два
|
||
из них:
|
||
|
||
- «Путь к файлу» - поле с кнопкой, открывающей диалог выбора файла.
|
||
Данное поле предназначено для выбора существующего файла, с которым
|
||
предстоит далее работать, либо для введения в него пути, по которому
|
||
необходимо будет создать новый файл. Обязательное поле;
|
||
|
||
- «Действие» - выпадающий список, состоящий из действий, которые можно
|
||
применить к загруженному файлу или создать новый с указанным путем в
|
||
поле «Путь к файлу». Обязательное поле;
|
||
|
||
<center><img src="../media/image164.png"/></center>
|
||
|
||
<center>Рис. 2. Перечень доступных действий модуля</center>
|
||
|
||
- «Описание» - поле, необходимое для удобной навигации по действиям,
|
||
заполняется комментарием разработчика о создаваемом действии.
|
||
Необязательное поле.
|
||
|
||
Все возможные действия будут описаны в следующей главе.
|
||
|
||
Для добавления действия в таблицу «Список команд» необходимо
|
||
воспользоваться кнопкой «Добавить» под полями настройки действия.
|
||
|
||
<center><img src="../media/image165.png"/></center>
|
||
|
||
<center>Рис. 3. Расположение кнопки «Добавить»</center>
|
||
|
||
После нажатия на кнопку созданное действие добавится в «Список команд».
|
||
Для редактирования существующей команды или её удаления, необходимо
|
||
выбрать строку с командой в таблице команд и нажать «Удалить» для её
|
||
удаления, или отредактировать необходимые поля действия и затем нажать
|
||
«Редактировать».
|
||
|
||
Для того, чтобы поменять существующие действия местами, необходимо
|
||
выбрать одно действие и нажать на необходимые кнопки «Поднять» или
|
||
«Опустить», которые расположены в правом углу над таблицей с командами.
|
||
|
||
<center><img src="../media/image166.png"/></center>
|
||
|
||
<center>Рис. 4. Кнопки «Поднять/Опустить» и выбор строки в таблице</center>
|
||
|
||
## Действия модуля
|
||
|
||
#### Создать файл
|
||
|
||
Данное действие создает файл с указанным путем, именем и расширением.
|
||
Для настройки действия необходимо заполнить поле «Путь к файлу» строкой
|
||
типа «*Путь до файла*/*Название файла*.*Требуемое расширение*»,
|
||
например, «C:/Reports/Documents/Test.docx».
|
||
|
||
<center><img src="../media/image167.png"/></center>
|
||
|
||
<center>Рис. 5. Пример заполнения действия «Создать файл»</center>
|
||
|
||
#### Получить текст
|
||
|
||
Действие «Получить текст» позволяет считать весь текст из загруженного
|
||
файла в переменную. Для настройки действия появляется еще одно поле
|
||
помимо стандартных трёх – «Переменная», в которую записывается название
|
||
переменной (с символов «v.»), в которую будет записан считанный текст.
|
||
|
||
<center><img src="../media/image168.png"/></center>
|
||
|
||
<center>Рис. 6. Пример настройки действия «Получить текст»</center>
|
||
|
||
#### Записать текст
|
||
|
||
С помощью действия можно записать имеющийся текст, например, считанный
|
||
из другого текстового файла, в текущий загруженный файл. Для настройки
|
||
обязательно заполнение поля «Значение», куда вводится либо переменная (с
|
||
символов «v.»), содержащая текст, либо сам текст. Обратите внимание, что
|
||
текст, введенный данным действием, полностью затрет существующий текст в
|
||
файле.
|
||
|
||
<center><img src="../media/image169.png"/></center>
|
||
|
||
<center>Рис. 7. Пример настройки действия «Записать текст»</center>
|
||
|
||
#### Добавить текст
|
||
|
||
Данное действие позволяет добавлять текст к существующему с применением
|
||
необходимого форматирования. Для редактирования открываются все поля
|
||
модуля. Далее будет подробно описано каждое поле, отличное от основных
|
||
трёх.
|
||
|
||
«После символа №» - данное поле ожидает ввод целого числа,
|
||
обозначающего, после какого по счету символа необходимо вставить текст
|
||
(с учетом пробелом и символов переноса строки или разрыва страницы).
|
||
|
||
<center><img src="../media/image170.png"/></center>
|
||
|
||
<center>Рис. 8. Пример настройки действия «Добавить текст»</center>
|
||
|
||
«Размер текста» - аналогичен полю «Размер шрифта» в Microsoft Word –
|
||
устанавливает размер добавляемого текста. Ожидается ввод целого или
|
||
десятичного числа.
|
||
|
||
«Шрифт» - выпадающий список, содержащий в себе набор стандартных шрифтов
|
||
пакета Micrisift Office – устанавливает шрифт добавляемого текста.
|
||
|
||
«Цвет текста» и «Цвет фона» – поля с иконкой палетки сбоку, по нажатию
|
||
на которые открывается диалог выбора цвета – устанавливают цвет
|
||
добавляемого текста и его фона соответственно. Вводится в формате цвета
|
||
HEX – шестнадцатеричное представление RGB.
|
||
|
||
«Текст» - поле, в которое указывается добавляемый текст или переменная,
|
||
которая его содержит.
|
||
|
||
#### Добавить перенос строки
|
||
|
||
Данное действие добавляет символ переноса строки в файл. Не требует
|
||
заполнения дополнительных полей.
|
||
|
||
<center><img src="../media/image171.png"/></center>
|
||
|
||
<center>Рис. 9. Пример настройки действия добавление перехода на новую строку</center>
|
||
|
||
#### Удалить текст
|
||
|
||
С помощью данного действия можно удалить текст, зная количество символов
|
||
в нем и его расположение. Для настройки необходимо ввести в поле «После
|
||
символа №, количество» два целых числа через запятую, где первое число –
|
||
номер символа, после которого необходимо удалить текст, а второе –
|
||
количество символов в удаляемом тексте.
|
||
|
||
<center><img src="../media/image172.png"/></center>
|
||
|
||
<center>Рис. 10. Пример настройки действия «Удалить текст»</center>
|
||
|
||
#### Экспорт
|
||
|
||
С помощью данного действия можно менять расширение загруженного файла.
|
||
Для настройки действия нужно выбрать из выпадающего списка «Тип» тип
|
||
файла, в который нужно экспортировать, и указать путь с названием и
|
||
расширением будущего файла в поле «Путь выходного файла».
|
||
|
||
<center><img src="../media/image173.png"/></center>
|
||
|
||
<center>Рис. 11. Пример настройки действия «Экспорт»</center>
|
||
|
||
#### Найти слово
|
||
|
||
Данное действие ищет слово или словосочетание (его точное совпадение)
|
||
в тексте и возвращает все его вхождения в тексте в виде массива
|
||
объектов (или таблицы с именованными колонками). Возвращаемые поля:
|
||
|
||
- start – начальный символ слова или словосочетания;
|
||
|
||
- end – конечный символ слова или словосочетания;
|
||
|
||
- text – искомое слово или словосочетание вместе с прилегающими к нему символами;
|
||
|
||
- pageNum – номер страницы, на которой было найдено слово или словосочетание.
|
||
|
||
<center><img src="../media/image387.png"/></center>
|
||
|
||
<center>Рис. 12. Пример настройки действия Найти слово</center>
|
||
|
||
Результат поиска будет выглядеть следующим образом:
|
||
|
||
<center><img src="../media/image388.png"/></center>
|
||
|
||
<center>Рис. 13. Пример результирующей переменной </center>
|