_Application.OnTime(Object, String, Object) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.