Поделиться через


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

Область применения: Access 2013, Office 2013

Для запуска макроса можно использовать действие RunMacro . Макрос может находиться в группе макросов.

Можно использовать следующее действие:

  • Выполнение макроса из другого макроса.

  • Выполнение макроса на основе определенного условия.

  • Присоединение макроса к пользовательской команде меню.

Setting

Аргументы действия RunMacro приведены ниже.

Аргумент макрокоманды

Описание

Имя макроса

Имя запускаемого макроса. В поле Имя макроса в разделе Аргументы действий панели построителя макросов отображаются все макросы (и группы макросов) в текущей базе данных. Если макрос находится в группе макросов, он отображается под именем группы макросов в списке как имя макрогруппы. имя_макроса. Это обязательный аргумент. При выполнении макроса, содержащего действие RunMacro в базе данных библиотеки, Microsoft Access ищет макрос с этим именем в базе данных библиотеки и не ищет его в текущей базе данных.

Число повторов

Максимальное количество запусков макроса. Если оставить этот аргумент пустым (а аргумент Repeat Expression также является пустым), макрос запускается один раз.

Выражение repeat

Выражение, которое имеет значение True (–1) или False (0). Макрос перестает выполняться, если выражение принимает значение False. Выражение вычисляется при каждом запуске макроса.

Замечания

Если ввести имя группы макросов для аргумента Имя макроса , Access запустит первый макрос в группе макросов.

Это действие аналогично щелчку запустить макрос на вкладке Работа с базами данных , выбору макроса и нажатию кнопки ОК. Однако эта команда выполняет макрос только один раз, в то время как действие RunMacro может выполнять макрос столько раз, сколько нужно.

Совет

Аргументы Repeat Count и Repeat Expression можно использовать, чтобы определить, сколько раз выполняется макрос:

  • Если оставить оба аргумента пустыми, макрос запускается один раз.
  • Если ввести число для параметра Число повторов , но оставить выражение повтора пустым, макрос будет выполнять указанное количество раз.
  • Если оставить значение Число повторений пустым, но ввести выражение для параметра Repeat Expression, макрос будет выполняться до тех пор, пока выражение не вычислит значение False.
  • Если ввести значения для обоих аргументов, макрос выполняет количество раз, указанное в параметре Число повторов , или до тех пор, пока выражение повтора не будет иметь значение False, в зависимости от того, что произойдет первым.

Когда вы запускаете макрос, содержащий действие RunMacro , и он достигает действия RunMacro , Access запускает вызываемую макрос. После завершения вызываемого макроса Access возвращается к исходному макросу и выполняет следующее действие.

Примечание.

  • Макрос можно вызвать в той же группе макросов или в другой группе макросов.
  • Можно вложить макросы. То есть можно запустить макрос A, который, в свою очередь, вызывает макрос B и т. д. В каждом случае после завершения вызываемого макроса Access возвращается к макросу, который его вызвал, и выполняет следующее действие в этом макросе.

Чтобы выполнить действие RunMacro в модуле Visual Basic для приложений (VBA), используйте метод RunMacro объекта DoCmd.