Чем мы можем вам помочь?
Макрокоманды
  • Макрокоманды
  • Надстройки
Приложение: Таблица macOS

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

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

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

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

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

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

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

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

1.Начните запись одним из следующих способов:

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

Если в документе есть хотя бы одна макрокоманда, на боковой панели нажмите кнопку side_panel_macro (Макрокоманды). На панели работы с макрокомандами нажмите на кнопку side_panel_macro_expand справа от кнопки Новая макрокоманда. В выпадающем списке выберите команду Записать макрокоманду (бета).

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

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

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

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

Если в документе есть хотя бы одна макрокоманда, на боковой панели нажмите кнопку side_panel_macro (Макрокоманды). На панели работы с макрокомандами нажмите на кнопку side_panel_macro_expand справа от кнопки Новая макрокоманда. В выпадающем списке выберите команду Остановить запись.

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

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

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

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

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

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

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

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

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

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

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

Нажмите на кнопку side_panel_macro (Макрокоманды), чтобы открыть панель работы с макрокомандами.

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

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

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

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

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

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

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

Макрокоманду можно выполнить с помощью редактора макрокоманд или панели работы с макрокомандами. Также для быстрого выполнения часто используемых макрокоманд можно создать кнопки в разделе панели инструментов Избранное.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

На боковой панели нажмите кнопку side_panel_macro (Макрокоманды). На панели работы с макрокомандами наведите курсор мыши на название требуемой макрокоманды и нажмите кнопку side_panel_macro_more (Еще). В выпадающем списке выберите команду Редактировать.

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

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

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

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

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

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

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

На боковой панели нажмите кнопку side_panel_macro (Макрокоманды). На панели работы с макрокомандами наведите курсор мыши на название требуемой макрокоманды и нажмите кнопку side_panel_macro_more (Еще). В выпадающем списке выберите команду Редактировать.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

На боковой панели нажмите кнопку side_panel_macro (Макрокоманды). На панели работы с макрокомандами наведите курсор мыши на название требуемой макрокоманды и нажмите кнопку side_panel_macro_more (Еще). В выпадающем списке выберите команду Редактировать.

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

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

Просмотреть код 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 (Макрокоманды). На панели работы с макрокомандами нажмите на кнопку side_panel_macro_expand справа от кнопки Новая макрокоманда. В выпадающем списке выберите команду Открыть редактор. В окне редактора макрокоманд выберите требуемый Lua-макрос.

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

3.В окне редактора макрокоманд отобразится код VBA-макросов, которые содержатся в соответствующем VBA-модуле. Перепишите код требуемого VBA-макроса на языке Lua.

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

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

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

Был ли материал полезным?
Да
Нет
Следующее
Надстройки