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

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

Приложение: Таблица macOS

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

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

•добавление формулы в ячейку;

•добавление текста в ячейку;

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

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

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

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

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

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

1.Записать последовательное выполнение действий, из которых должна состоять макрокоманда.

2.Ввести текст макрокоманды вручную.

Чтобы записать макрокоманду:

1.Выберите пункт командного меню Инструменты > Макрокоманды > Записать макрокоманду (бета).

2.Выполните последовательность действий, из которых должна состоять макрокоманда.

В текущей версии приложения не все действия пользователя доступны для записи. При выполнении действия, запись которого не поддерживается, на экране отображается всплывающее сообщение «Действие не может быть записано».

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

•Выберите пункт командного меню Инструменты > Макрокоманды > Остановить запись.

•В строке состояния нажмите кнопку status_bar_macro_stop_recording Остановить запись.

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

При успешном сохранении макрокоманды на экране отобразится всплывающее сообщение «Макрокоманда "имя_макрокоманды" сохранена».

Чтобы ввести текст макрокоманды вручную:

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 Excel. Но вы можете просмотреть код VBA-макросов, которые содержатся в документе, и переписать их на языке Lua.

Для просмотра доступны VBA-макросы, сохраненные в "Этой книге".

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

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

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.Сохраните документ в формате XLSX с помощью команды Сохранить как.

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

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

Да

Нет