_Application.OnTime(Object, String, Object) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Запускает фоновый таймер, который запускает макрос в указанное время.
public void OnTime (ref object When, string Name, ref object Tolerance);abstract member OnTime : obj * string * obj -> unitPublic 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. При запуске другого таймера перед запуском существующего таймера существующий таймер будет отменен.