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


_Application.OnTime(Object, String, Object) Метод

Определение

Запускает фоновый таймер, который запускает макрос в указанное время.

public void OnTime (ref object When, string Name, ref object Tolerance);
abstract member OnTime : obj * string * obj -> unit
Public Sub OnTime (ByRef When As Object, Name As String, Optional ByRef Tolerance As Object)

Параметры

When
Object

Обязательный объект. Время выполнения макроса. Может быть строкой, указывающей время (например, "16:30 вечера" или "16:30"), или серийным номером, возвращаемым функцией, такой как TimeValue или TimeSerial (например, TimeValue("2:30 pm") или TimeSerial(14, 30, 00)). Можно также указать дату (например, "16:30 16:15" или TimeValue("06/30 16:15")). Используйте сумму возвращаемых значений функции Now и функции TimeValue или TimeSerial , чтобы задать таймер для выполнения макроса через указанное время после выполнения инструкции. Например, используйте now+TimeValue("00:05:30"), чтобы запустить макрос через 5 минут и 30 секунд после выполнения инструкции.

Name
String

Обязательный атрибут типа String. Имя выполняемого макроса. Используйте полный путь к макросу, чтобы убедиться, что выполняется правильный макрос (например, Project.Module1.Macro1). Чтобы макрос выполнялся, документ или шаблон должны быть доступны как при выполнении инструкции OnTime , так и в то время, указанное параметром When . По этой причине лучше сохранить макрос в Normal.dot или другом глобальном шаблоне, который загружается автоматически.

Tolerance
Object

Необязательный объект. Максимальное время (в секундах), которое может пройти до отмены макроса, который не был запущен в указанное в нее When время. Макросы не всегда могут выполняться в указанное время. Например, если выполняется операция сортировки или отображается диалоговое окно, макрос будет отложен до тех пор, пока Word не завершит задачу. Если этот аргумент равен 0 (ноль) или опущен, макрос выполняется независимо от того, сколько времени прошло с момента, указанного параметром When.

Комментарии

Microsoft Word может поддерживать только один фоновый таймер, заданный OnTime. При запуске другого таймера перед запуском существующего таймера существующий таймер будет отменен.

Применяется к