_Application.OnTime(Object, String, Object) Método

Definición

Espacio de nombres:

Microsoft.Office.Interop.Word

Ensamblado:

Microsoft.Office.Interop.Word.dll

Inicia un temporizador en segundo plano que ejecuta una macro a una hora especificada.

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)

Parámetros

When

Object

Objeto obligatorio. Hora a la que va a ejecutarse la macro. Puede ser una cadena que especifica una hora (por ejemplo, "4:30 pm" o "16:30"), o puede ser un número de serie devuelto por una función como TimeValue o TimeSerial (por ejemplo, TimeValue("2:30 pm") o TimeSerial(14, 30, 00)). También puede incluir la fecha (por ejemplo, "6/30 4:15 pm" o TimeValue("6/30 4:15 pm")). Use la suma de los valores devueltos de la función Now y la función TimeValue o TimeSerial para establecer un temporizador para ejecutar una macro una cantidad de tiempo especificada después de ejecutar la instrucción. Por ejemplo, use Now+TimeValue("00:05:30") para ejecutar una macro 5 minutos y 30 segundos después de que se ejecute la instrucción.

Name

String

String requerida. Nombre de la macro que va a ejecutarse. Use la ruta de acceso de macro completa para asegurarse de que se ejecuta la macro correcta (por ejemplo, "Project.Module1.Macro1"). Para que se ejecute la macro, el documento o la plantilla deben estar disponibles tanto cuando se ejecuta la instrucción OnTime como cuando llega la hora especificada por When . Por este motivo, es mejor almacenar la macro en Normal.dot u otra plantilla global que se cargue automáticamente.

Tolerance

Object

Objeto opcional. Se cancela el tiempo máximo (en segundos) que puede transcurrir antes de que se cancele una macro que no se ejecutó en el momento especificado por When . Las macros no siempre se ejecutan a la hora especificada. Por ejemplo, si se está efectuado una operación de ordenación o se muestra un cuadro de diálogo, la macro se retrasa hasta que Word haya concluido la tarea. Si este argumento es 0 (cero) o se omite, la macro se ejecuta independientemente del tiempo transcurrido desde el tiempo especificado por When.

Comentarios

Microsoft Word solo puede mantener un temporizador en segundo plano establecido por OnTime. Si inicia otro temporizador antes de que se ejecute uno existente, se cancela el temporizador existente.