Надстройки на Lua в приложениях МойОфис. Книга 3
Покупка
Новинка
Тематика:
Программирование и алгоритмизация
Издательство:
ДМК Пресс
Автор:
Шульгин Дмитрий Геннадьевич
Год издания: 2024
Кол-во страниц: 212
Дополнительно
Вид издания:
Практическое пособие
Уровень образования:
Профессиональное образование
ISBN: 978-5-93700-328-7
Артикул: 890864.01.99
Современные офисные программы предоставляют широкий набор возможностей для подготовки электронных документов. В большинстве случаев стандартных, «из коробки», функций редактирования вполне достаточно. Ситуация, когда пользователю необходимы инструменты, выходящие за рамки основной функциональности приложения, возникают все чаще при обработке отдельных видов документов, работе с большими объемами информации, взаимодействии с корпоративными сервисами или особых режимах информационной безопасности. Офисный пакет МойОфис предоставляет механизм для расширения своих функциональных возможностей с помощью дополнительных программ — надстроек. Разработчику надстройки доступны широкие возможности, включая взаимодействие с рабочим документом, создание форм управления ввода данных, печать, подключение сторонних модулей и др. Книга рассматривает аспекты применения языка программирования Lua для создания надстроек в табличном или текстовом редакторе МойОфис.
Книга содержит описание языка Lua в объеме, достаточном для разработки модуля надстройки, а также описание объектной модели МойОфис. В нескольких главах рассматривается работа с абзацами, списками, табличными листами и диапазонами, инструментами для рецензирования документов и пр. В конце каждой главы представлены контрольные вопросы и задания для самопроверки. Освоив эту книгу, вы сможете создавать собственные надстройки для приложений «МойОфис Текст» и «МойОфис Таблица».
Книга рассчитана на широкий круг читателей — опытных пользователей офисных программ, ИТ-специалистов, разработчиков.
Тематика:
ББК:
УДК:
ОКСО:
- ВО - Бакалавриат
- 09.03.01: Информатика и вычислительная техника
- 09.03.02: Информационные системы и технологии
- 09.03.04: Программная инженерия
ГРНТИ:
Скопировать запись
Фрагмент текстового слоя документа размещен для индексирующих роботов
Д. Г. Шульгин Надстройки на Lua в приложениях МойОфис Книга 3 Москва, 2025
УДК 004.91МойОфис ББК 32.972.13 Ш95 Шульгин Д. Г. Ш95 Надстройки на Lua в приложениях МойОфис. – Кн. 3. – М.: ДМК Пресс, 2024. – 210 с.: ил. ISBN 978-5-93700-328-7 Современные офисные программы предоставляют широкий набор возможностей для подготовки электронных документов. В большинстве случаев стандартных, «из коробки», функций редактирования вполне достаточно. Ситуация, когда пользователю необходимы инструменты, выходящие за рамки основной функциональности приложения, возникают все чаще при обработке отдельных видов документов, работе с большими объемами информации, взаимодействии с корпоративными сервисами или особых режимах информационной безопасности. Офисный пакет МойОфис предоставляет механизм для расширения своих функциональных возможностей с помощью дополнительных программ – надстроек. Разработчику надстройки доступны широкие возможности, включая взаимодействие с рабочим документом, создание форм управления ввода данных, печать, подключение сторонних модулей и др. Книга рассматривает аспекты применения языка программирования Lua для создания надстроек в табличном или текстовом редакторе МойОфис. Книга содержит описание языка Lua в объеме, достаточном для разработки модуля надстройки, а также описание объектной модели МойОфис. В нескольких главах рассматривается работа с абзацами, списками, табличными листами и диапазонами, инструментами для рецензирования документов и пр. В конце каждой главы представлены контрольные вопросы и задания для самопроверки. Освоив эту книгу, вы сможете создавать собственные надстройки для приложений «МойОфис Текст» и «МойОфис Таблица». Книга рассчитана на широкий круг читателей – опытных пользователей офисных программ, ИТ-специалистов, разработчиков. УДК 004.91МойОфис ББК 32.972.13 Все права защищены. Любая часть этой книги не может быть воспроизведена в какой бы то ни было форме и какими бы то ни было средствами без письменного разрешения владельцев авторских прав. © Шульгин Д. Г., 2024 ISBN 978-5-93700-328-7 © Оформление, издание, ДМК Пресс, 2024
СОДЕРЖАНИЕ Раздел I. ЯЗЫК LUA...................................................................................................7 Занятие 1. Введение в разработку макрокоманд.................................................8 1.1. Что такое макрокоманды и почему на языке Lua......................................................8 1.2. Обзор редактора макрокоманд в МойОфис.............................................................10 1.3. Запуск простой макрокоманды...............................................................................15 Контрольные вопросы и задания...................................................................................16 Дополнительная информация.......................................................................................16 Занятие 2. Переменные и типы данных ..............................................................17 2.1. Понятие переменной и правила использования.....................................................17 2.2. Типы данных в языке программирования Lua........................................................20 2.3. Множественное присваивание................................................................................27 2.4. Комментарии к коду макрокоманд.........................................................................28 Контрольные вопросы и задания...................................................................................29 Занятие 3. Вычисления в Lua..................................................................................30 3.1. Арифметические операторы...................................................................................30 3.2. Операторы сравнения.............................................................................................32 3.3. Логические операции..............................................................................................33 3.4. Приоритет операций в Lua......................................................................................33 3.5. Конкатенация строк.................................................................................................34 3.6. Оператор вычисления длины..................................................................................34 3.7. Функции стандартной библиотеки math.................................................................34 Контрольные задания....................................................................................................35 Занятие 4. Обработка строковых значений.........................................................37 4.1. Установка значения переменной.............................................................................37 4.2. Определение длины строки.....................................................................................38 4.3. Конкатенация строк с помощью оператора ............................................................40 4.4. Функции преобразования значений tostring и tonumber........................................41 4.5. ESC-последовательности.........................................................................................42 4.6. Функции стандартной библиотеки Lua для работы со строками.............................43 4.7. Функции модуля utf8 для работы со строками на русском языке............................44 Контрольные задания....................................................................................................47 Занятие 5. Управляющие конструкции..................................................................48 5.1. Условный оператор if...............................................................................................49 5.2. Оператор цикла while..............................................................................................52 5.3. Операторы цикла repeat-until..................................................................................53 5.4. Оператор цикла for..................................................................................................55 5.5. Оператор прерывания цикла break..........................................................................58
4 Содержание 5.6. Оператор безусловного перехода goto.....................................................................58 5.7. Оператор возврата значения функции return..........................................................59 Контрольные вопросы и задания...................................................................................60 Занятие 6. Функции...................................................................................................61 6.1. Назначение и способы объявления пользовательских функций.............................61 6.2. Аргументы функции................................................................................................62 6.3. Возвращаемые значения.........................................................................................65 6.4. Назначение и передача функции............................................................................66 Контрольные вопросы и задания...................................................................................66 Занятие 7. Таблицы и структуры данных..............................................................67 7.1. Создание и наполнение таблиц...............................................................................67 7.2. Доступ к элементам таблицы...................................................................................68 7.3. Функции стандартной библиотеки для управления таблицами..............................69 Контрольные вопросы и задания...................................................................................70 Занятие 8. Обработка ошибок.................................................................................72 8.1. Виды ошибок...........................................................................................................72 8.2. Указание текста сообщения об ошибке...................................................................73 8.3. Перехват ошибки.....................................................................................................74 8.4. Возвращаемые значения.........................................................................................76 Занятие 9. Метатаблицы..........................................................................................77 9.1. Перегрузка оператора..............................................................................................77 9.2. Обращение по несуществующему ключу................................................................78 9.3. Расширение таблицы...............................................................................................80 Занятие 10. Отладчик макрокоманд в МойОфис................................................82 10.1. Типы ошибок и понятие «отладчик»......................................................................82 10.2. Интерфейс отладчика кода макрокоманд..............................................................84 10.3. Выполнение пошаговой отладки на примере........................................................87 10.4. Работа со стеком вызовов......................................................................................91 10.5. Использование точки останова..............................................................................94 Контрольные вопросы и задания...................................................................................96 Раздел II. НАДСТРОЙКИ НА LUA В РЕДАКТОРАХ МОЙОФИС................97 Занятие 1. Введение в разработку надстроек в редакторах МойОфис.........98 1.1. Назначение надстройки..........................................................................................98 1.2. Возможности...........................................................................................................99 1.3. Язык программирования Lua, окружение и модули..............................................100 1.4. Объектная модель МойОфис.................................................................................101 1.5. Установка надстройки Runtime для «МойОфис Текст»..........................................102 1.6. Использование надстройки для «МойОфис Текст»................................................103 Занятие 2. Структура модуля надстройки...........................................................105 2.1. Разработка надстройки.........................................................................................106 2.2. Файловая структура надстройки...........................................................................106 2.3. Создание надстройки............................................................................................108
Содержание 5 2.4. Подготовка файла регистрации.............................................................................109 2.5. Использование необязательных ключей конфигурации.......................................110 2.6. Подготовка файла сценария..................................................................................111 2.7. Подготовка файла лицензионного соглашения.....................................................114 2.8. Сборка надстройки................................................................................................114 2.9. Подписание надстройки........................................................................................115 2.10. Запуск..................................................................................................................116 Занятие 3. Структура модуля надстройки. Контекст.........................................117 3.1. Введение................................................................................................................117 3.2. Контекст приложения............................................................................................118 3.3. Контекст документа...............................................................................................119 3.4. Контекст фрагмента...............................................................................................120 Занятие 4. Абзацы и списки...................................................................................121 4.1. Введение................................................................................................................122 4.2. Контекст взаимодействия и доступ к рабочему документу...................................122 4.3. Определение и выделение диапазона...................................................................124 4.4. Удаление текста диапазона....................................................................................125 4.5. Вставка текста в документ.....................................................................................126 4.6. Форматирование текста в документе....................................................................126 4.7. Списки...................................................................................................................128 4.8. Управление защищенным контентом...................................................................129 Занятие 5. Таблицы..................................................................................................131 5.1. Введение................................................................................................................132 5.2. Создание таблицы в текстовом документе............................................................132 5.3. Заполнение таблицы..............................................................................................133 5.4. Добавление строк и столбцов................................................................................135 5.5. Форматирование ячейки таблицы.........................................................................137 5.6. Диапазоны ячеек...................................................................................................138 5.7. Удаление строк, столбцов и таблицы.....................................................................140 Занятие 6. Работа с изображениями....................................................................141 6.1. Возможности работы с изображением..................................................................141 6.2. Вставка изображения.............................................................................................142 6.3. Список изображений.............................................................................................142 6.4. Список графических объектов...............................................................................143 6.5. Работа с рамкой для встроенного объекта (Frame)................................................144 Контрольные вопросы и задания.................................................................................145 Занятие 7. Закладки в текстовом документе.....................................................146 7.1. Введение................................................................................................................146 7.2. Поиск закладки в текстовом документе................................................................148 7.3. Установка закладки в текстовом документе..........................................................149 7.4. Удаление закладки.................................................................................................151 Занятие 8. Рецензирование документа...............................................................152 8.1. Инструменты для рецензирования документа......................................................153
6 Содержание 8.2. Работа со списком изменений в текстовом документе.........................................154 8.3. Работа со списком комментариев в текстовом документе....................................156 Занятие 9. Листы......................................................................................................158 9.1. Введение................................................................................................................159 9.2. Переименование листа..........................................................................................159 9.3. Добавление новых листов в книгу.........................................................................160 9.4. Копирование и перемещение листов....................................................................161 9.5. Удаление листов....................................................................................................162 9.6. Перечисление листов.............................................................................................162 9.7. Выбор листа...........................................................................................................162 9.8. Скрытие листов.....................................................................................................162 Занятие 10. Ячейки и группы ячеек.....................................................................164 10.1. Доступ к ячейке....................................................................................................165 10.2. Установка значений.............................................................................................165 10.3. Считывание значений.........................................................................................167 10.4. Форматирование ячейки.....................................................................................167 10.5. Диапазон ячеек....................................................................................................170 10.6. Настройка границ................................................................................................170 10.7. Объединение ячеек..............................................................................................171 10.8. Добавление строк и столбцов..............................................................................172 10.9. Удаление строк и столбцов..................................................................................173 Занятие 11. Печать..................................................................................................175 11.1. Печать документа................................................................................................175 11.2. Печать выделенного фрагмента..........................................................................177 11.3. Печать области.....................................................................................................177 Занятие 12. Работа с файлами..............................................................................179 Занятие 13. Разработка форм ввода данных....................................................182 13.1. Введение..............................................................................................................183 13.2. Создание надстройки..........................................................................................184 13.3. Создание диалогового окна.................................................................................184 13.4. Список каталогов.................................................................................................188 13.5. Список файлов.....................................................................................................191 13.6. Имя файла............................................................................................................194 13.7. Выбор отображаемых файлов..............................................................................195 13.8. Компоновки и виджеты.......................................................................................197 Занятие 14. Работа с файлами..............................................................................200 Занятие 15. Локализация надстройки.................................................................202 15.1. Введение..............................................................................................................202 15.2. Словарь локализации...........................................................................................204 15.3. Локализация полей таблицы регистрации..........................................................204 15.4. Локализация формы ввода..................................................................................208
Раздел I ЯЗЫК LUA
Введение в разработку макрокоманд В ХОДЕ ЗАНЯТИЯ ВЫ: узнаете, зачем нужны макрокоманды и особенности их использования в редакторах МойОфис; познакомитесь с возможностями встроенного редактора макрокоманд: создавать, удалять и переименовывать макрокоманды; запустите первую макрокоманду на Lua в приложении МойОфис. СОДЕРЖАНИЕ ЗАНЯТИЯ 1.1. Что такое макрокоманды и почему на языке Lua 1.2. Обзор редактора макрокоманд в МойОфис 1.3. Запуск простой макрокоманды Контрольные вопросы и задания Дополнительная информация 1.1. Что такое макрокоманды и почему на языке Lua При работе с текстом, таблицами, фигурами или иными объектами в документах пользователь офисного ПО выполняет различные операции, используя кнопки на панели инструментов, пункты основного и контекстного меню, горячие клавиши. При этом каждое действие пользователя запускает ровно одну операцию над выбранным объектом. Чтобы ускорить работу пользователей, разработчики редакторов создали множество инструментов, позволяющих выполнить сразу несколько операций с выбранными объектами, например в текстовых редакторах с помощью стилей можно сразу изменить настройки шрифта и абзаца, во всех редакторах с помощью «кисточки» быстро перенести форматирование с одного
Что такое макрокоманды и почему на языке Lua 9 объекта на другой, в табличном редакторе – автоматически применять форматирование к новым строкам. Но что делать, если одну и ту же последовательность действий необходимо выполнить на нескольких листах в табличном документе? Или даже выполнить действия с несколькими разными объектами? Для этого придуманы макрокоманды (дословно – команды, которые позволяют выполнить несколько простых команд). Макрокоманды (макросы) представляют собой программы небольшого размера, с помощью которых пользователь автоматизирует выполнение продолжительных или часто повторяющихся операций внутри документов. С помощью макрокоманд можно решать следующие задачи работы с документами и данными в них: автоматизировать форматирование текста; проверить корректность данных; отредактировать документ, заменить одни данные на другие. Макросы фиксируются в виде программ на том языке программирования, который поддерживается в редакторах. Начинающие пользователи предпочитают работу с функцией «Запись макрокоманды», которая формирует код макроса, фиксируя действия пользователя. Опытные пользователи создают макросы «с нуля» во встроенной среде разработки, что позволяет использовать все возможности языка программирования, в том числе реализовать сценарии обработки данных, недоступные в интерфейсе программы. Для того чтобы пользователи могли самостоятельно разобраться в работе макросов, их создают и редактируют с использованием скриптовых языков программирования, для которых характерны следующие черты: простой синтаксис, что обеспечивает быстрый старт; хранение программ в виде текста, что упрощает изучение, отладку и контроль работы макросов; выполнение программ с использованием интерпретатора (специальной программы, переводящей код в действия только при непосредственном вызове), что позволяет выполнять макросы по отдельности. В редакторах МойОфис разработка макрокоманд ведется на языке программирования Lua, который не только является скриптовым языком программирования, но и обеспечивает дополнительные возможности: макросы одинаково работают в настольных редакторах МойОфис для ОС Linux, для ОС Windows и в веб-редакторах; не требует покупки дополнительного ПО или специальных лицензий для работы; допускает подключение внешних модулей для расширения функциональных возможностей – так реализован доступ к объектам в документе. Для создания макрокоманд в редакторах МойОфис можно использовать встроенные средства программирования или специальную функцию «Запись макрокоманды», которая фиксирует действия пользователя и сохраняет в виде программы.
10 Введение в разработку макрокоманд СПРАВОЧНО Язык Lua разработан в 1993 году как средство программирования для пользователей, не являющихся профессиональными программистами. Малый размер интерпретатора, относительно высокая скорость исполнения и легкая расширяемость позволили этому языку найти применение в сфере разработки компьютерных игр (в 2003 году Lua был признан самым популярным скриптовым языком для разработки игр, по версии сообщества GameDev.net). Также Lua активно используется для написания расширений и плагинов к программным продуктам, при создании пользовательских интерфейсов и в конфигурационных файлах. Таким образом, язык Lua – интерпретируемый язык, созданный специально для непрограммистов, прост в освоении и платформонезависимый, а также давно зарекомендовал себя на мировом рынке как эффективный скриптовый язык. 1.2. Обзор редактора макрокоманд в МойОфис Диалоговое окно Редактирование макроса открывает доступ к редактору макрокоманд, с помощью которого пользователь создает и запускает макрокоманду. Запустите приложение «МойОфис Текст», затем в командном меню выберите Макрокоманды – Редактор макрокоманд (рис. 1.1). Рис. 1.1 Окно приложения «МойОфис Текст»