Макрокоманды

Продукт: МойОфис Стандартный 3, МойОфис Профессиональный 3

Приложение: Текст macOS

Макрокоманды представляют собой программы небольшого размера, с помощью которых в текстовом документе автоматизируется выполнение продолжительных или часто повторяющихся операций. Для разработки макрокоманд в «МойОфис Текст» используется язык программирования Lua.

Как правило, макрокоманды используются для решения следующих задач:

•добавление текста;

•поиск и замена по тексту;

•удаление текста.

Сохранение макрокоманд поддерживается только в пределах текущего документа. Если аналогичные макрокоманды требуется использовать в другом документе, следует создать их непосредственно в другом документе.

Подробное описание работы с макрокомандами приведено в документе «Справочник макрокоманд на языке программирования Lua».

Создать макрокоманду

Чтобы создать макрокоманду, выполните следующие действия:

1.Выберите пункт командного меню Инструменты > Редактор макрокоманд.

2.В окне Редактор макрокоманд нажмите кнопку macros_add_script_icon .

3.Введите имя макрокоманды или оставьте имя, указанное по умолчанию. Чтобы сохранить имя, нажмите клавишу enter Enter или щелкните мышью по любой области редактора макрокоманд.

4.Введите текст макрокоманды.

Новая макрокоманда сохраняется автоматически.

При добавлении в документ макрокоманды на боковой панели появляется кнопка side_panel_macro (Макрокоманды). При нажатии на данную кнопку открывается панель работы с макрокомандами, с помощью которой можно выполнить следующие действия:

•найти макрокоманду;

•выполнить макрокоманду;

•открыть редактор макрокоманд.

Чтобы закрыть панель работы с макрокомандами, нажмите на кнопку side_panel_macro_close , расположенную над строкой поиска, или повторно нажмите на кнопку (Макрокоманды) на боковой панели.

Кнопка side_panel_macro (Макрокоманды) отображается на боковой панели до тех пор, пока документ содержит хотя бы одну макрокоманду.

Найти макрокоманду

Если документ содержит большое количество макрокоманд, для быстрого поиска требуемой макрокоманды выполните следующие действия:

1.На боковой панели нажмите кнопку side_panel_macro (Макрокоманды).

2.На панели работы с макрокомандами укажите в строке поиска часть названия или название требуемой макрокоманды целиком.

В списке макрокоманд отобразятся макрокоманды, названия которых удовлетворяют указанным результатам поиска.

Выполнить макрокоманду

Макрокоманду можно выполнить с помощью редактора макрокоманд или с помощью панели работы с макрокомандами.

Чтобы выполнить макрокоманду с помощью редактора макрокоманд:

1.Выберите пункт командного меню Инструменты > Редактор макрокоманд.

2.В окне Редактор макрокоманд выберите требуемую макрокоманду из списка.

3.Нажмите кнопку macros_run Выполнить.

Информация о выполнении макрокоманды отобразится в области Результат.

Чтобы выполнить макрокоманду с помощью панели работы с макрокомандами:

1.На боковой панели нажмите кнопку side_panel_macro (Макрокоманды).

2.Запустите макрокоманду одним из следующих способов:

•На панели работы с макрокомандами наведите курсор мыши на название макрокоманды и нажмите кнопку side_panel_macro_execute (Выполнить).

•Выделите строку макрокоманды двойным щелчком мыши.

Редактировать макрокоманду

Чтобы редактировать макрокоманду, выполните следующие действия:

1.Откройте редактор макрокоманд одним из следующих способов:

•Выберите пункт командного меню Инструменты > Редактор макрокоманд.

•На боковой панели нажмите кнопку side_panel_macro (Макрокоманды). На панели работы с макрокомандами наведите курсор мыши на название макрокоманды, которую требуется редактировать, и нажмите кнопку side_panel_macro_edit (Редактировать).

2.В окне Редактор макрокоманд выберите требуемую макрокоманду из списка.

3.Внесите необходимые изменения в ее текст.

Изменения в тексте макрокоманды сохраняются автоматически.

Отладить макрокоманду

Перед запуском отладчика макрокоманд установите в тексте макрокоманды точки останова отладчика. Для этого:

1.Откройте редактор макрокоманд одним из следующих способов:

•Выберите пункт командного меню Инструменты > Редактор макрокоманд.

2.В окне Редактор макрокоманд выберите требуемую макрокоманду из списка.

3.Установите первую точку останова отладчика. Для этого щелкните мышью справа от номера строки, в которой необходимо создать точку останова. Точка останова будет обозначена значком macros_breakpoint .

4.Установите другие точки останова аналогичным образом.

Если требуется удалить какую-либо точку останова, щелкните по ней мышью.

Для отладки макрокоманды выполните следующие действия:

1.Нажмите кнопку macros_debug Отладить. Запустится процесс отладки макрокоманды. Если в тексте макрокоманды содержатся точки останова, то процесс отладки остановится на строке, которая содержит первую точку. Если точки останова отсутствуют, то процесс отладки остановится на первой строке макрокоманды.

2.Для управления шагами отладки используйте следующие кнопки:

macros_step_into (Шаг с заходом) – выполнить один шаг отладки или заход в тело функции, если таковая есть в текущей позиции отладки;

macros_step_over (Шаг с обходом) – выполнить один шаг отладки без захода в тело функции;

macros_step_out (Шаг с выходом) – продолжить выполнение макрокоманды до момента выхода из функции, в которой отладчик находится в текущей позиции.

В процессе отладки в окне редактора макрокоманд отображаются следующие области:

•Выполнение – окно для вывода сообщений во время отладки;

•Стек вызовов – окно стека вызовов;

•Переменные – окно вывода значений локальных и глобальных переменных, доступных на текущем шаге выполнения макрокоманды. Если отображаемая переменная представляет из себя таблицу или массив, то при нажатии кнопки macros_variable , расположенной слева от имени переменной, доступен просмотр ее содержимого в развернутом виде.

Отладка завершается при достижении конца макрокоманды.

Если требуется прервать процесс отладки, нажмите кнопку macros_stop (Остановить макрокоманду).

Удалить макрокоманду

Чтобы удалить макрокоманду, выполните следующие действия:

1.Откройте редактор макрокоманд одним из следующих способов:

•Выберите пункт командного меню Инструменты > Редактор макрокоманд.

•На боковой панели нажмите кнопку side_panel_macro (Макрокоманды). На панели работы с макрокомандами наведите курсор мыши на название макрокоманды, которую требуется удалить, и нажмите кнопку side_panel_macro_edit (Редактировать).

2.В окне Редактор макрокоманд выберите требуемую макрокоманду из списка.

3.Нажмите кнопку macros_delete_script_icon .

4.В открывшемся окне подтвердите удаление макрокоманды.

Просмотреть код VBA-макроса

В приложении «МойОфис Текст» недоступен запуск VBA-макросов, созданных в Microsoft Word. Но вы можете просмотреть код VBA-макросов, которые содержатся в документе, и переписать их на языке Lua.

Для просмотра доступны VBA-макросы, сохраненные в текущем документе Microsoft Word.

Чтобы просмотреть и переписать код VBA-макроса, выполните следующие действия:

1.Откройте DOCM-документ.

2.Выберите Lua-макрос с названием VBA-модуля, в котором содержится требуемый VBA-макрос. Например, если VBA-макрос Macro1 содержится в VBA-модуле Module1, выберите Lua-макрос Module1. Для выбора Lua-макроса выполните одно из следующих действий:

•Выберите пункт командного меню Инструменты > Редактор макрокоманд. В окне Редактор макрокоманд выберите требуемый Lua-макрос.

•На боковой панели нажмите кнопку side_panel_macro (Макрокоманды). На панели работы с макрокомандами наведите курсор мыши на название требуемого Lua-макроса и нажмите кнопку side_panel_macro_edit (Редактировать).

В окне Редактор макрокоманд отобразится код VBA-макросов, которые содержатся в соответствующем VBA-модуле.

3.Перепишите код требуемого VBA-макроса на языке Lua.

4.Закройте окно редактора макрокоманд.

5.Сохраните документ в формате DOCX с помощью команды Сохранить как.

В исходном DOCM-документе внесенные изменения не сохраняются.

Был ли материал полезным?

Да

Нет