_Application.OnTime(Object, String, Object) 方法

定义

命名空间:

Microsoft.Office.Interop.Word

程序集:

Microsoft.Office.Interop.Word.dll

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

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

必需的 对象。 运行宏的时间。 可以是指定时间 (的字符串，例如， “4：30 pm”或“16：30”) ，也可以是 TimeValue 或 TimeSerial (等函数返回的序列号，例如 TimeValue (“2：30 pm”) 或 TimeSerial (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 时间到达时，文档或模板必须可用。 因此，最好将宏存储在 Normal.dot 或其他自动加载的全局模板中。

Tolerance

Object

可选 对象。 取消在指定的 When 时间未运行的宏之前， (的最大时间（以秒为单位）。) 。 宏不一定总在指定时间运行。 例如，如果正在进行排序操作，或者正在显示某一对话框，则宏将延迟到 Word 完成当前任务后才运行。 如果此参数为 0 (零) 或省略，则无论自 指定的 When时间以来已经过多少时间，都会运行宏。

注解

Microsoft Word只能维护 OnTime 设置的一个后台计时器。 如果在现有计时器运行之前，您可以启动另一个计时器，则取消现有计时器。