OnTime 方法

启动在指定日期的指定时间运行宏的后台计时器。

expression  必选。返回 Application 对象的表达式。

When  必选，Variant 类型。运行宏的时间。可以是指定时间的字符串（例如 "4:30 pm" 或 "16:30"），也可以是由 TimeValue 或 TimeSerial 等函数返回的一系列数字（例如 TimeValue("2:30 pm") 或 TimeSeria(14, 30, 00)）。您也可以包括日期（例如 "6/30 4:15 pm" 或 TimeValue("6/30 4:15 pm")）。

使用 Now 函数以及 TimeValue 或 TimeSerial 函数的返回值的和可以设置计时器，使宏在语句运行后的指定时间运行。例如，使用 Now+TimeValue("00:05:30") 可以使宏在语句运行后再过 5 分 30 秒运行。

Name  必选，String 类型。要运行的宏的名称。使用完整的宏路径可以确保运行的是正确的宏（例如 “Project.Module1.Macro1”）。对于要运行的宏，当运行 OnTime 方法时以及 When 指定的时间到达时，文档或模板必须同时都可用。

Tolerance  可选，Variant 类型。未能在由 When 指定的时间运行的宏取消之前所能 经过的最长时间（以秒为单位）。宏不一定始终在指定时间运行。例如，如果正在显示对话框，则宏会延迟到 Microsoft FrontPage 完成该任务之后。如果此参数为 0（零）或省略，则不管在由 When 指定的时间之后又过了多长时间，宏都将运行。

说明

Microsoft FrontPage 仅可以维护一个由 OnTime 方法设置的后台记时器。如果在现有计时器运行之前启动了另一个计时器，则现有计时器会被取消。

示例

本示例在 3:55 P.M 运行当前模块中名为“Macro1”的宏。

Application.OnTime When:=Timevalue("15:55:00"), Name:="Macro1"

本示例在运行 15 秒后运行名为“Macro1”的宏。

Application.OnTime When:=Now + TimeValue("00:00:15"), _
    Name:="Project1.Module1.Macro1"

本示例在 1:30 P.M 运行名为“Start”的宏。宏的名称包括了项目名称和模块名称。