_Application.OnTime(Object, String, Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicia um cronômetro em segundo plano que executa uma macro em uma hora especificada.
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)Parâmetros
- When
- Object
Objeto obrigatório. A hora em que a macro será executada. Pode ser uma cadeia de caracteres que especifica uma hora (por exemplo, "16:30" ou "16:30"), ou pode ser um número de série retornado por uma função como TimeValue ou TimeSerial (por exemplo, TimeValue("14:30 pm") ou TimeSerial(14, 30, 00)). Você também pode incluir a data (por exemplo, "30/6 16:15" ou TimeValue("30/6 16:15")). Use a soma dos valores retornados da função Now e a função TimeValue ou TimeSerial para definir um temporizador para executar uma macro um tempo especificado após a execução da instrução. Por exemplo, use Now+TimeValue("00:05:30") para executar uma macro 5 minutos e 30 segundos após a instrução ser executada.
- Name
- String
String necessário. O nome da macro a ser executada. Use o caminho de macro completo para garantir que a macro correta seja executada (por exemplo, "Project.Module1.Macro1"). Para que a macro seja executada, o documento ou modelo deve estar disponível quando a instrução OnTime for executada e quando a hora especificada por When chegar. Por esse motivo, é melhor armazenar a macro em Normal.dot ou em outro modelo global carregado automaticamente.
- Tolerance
- Object
Objeto opcional. O tempo máximo (em segundos) que pode passar antes de uma macro que não foi executada no momento especificado pelo When é cancelada. As macros podem não ser sempre executadas na hora especificada. Por exemplo, se uma operação de classificação estiver em andamento ou uma caixa de diálogo estiver sendo exibida, a macro se atrasará até que o Word tenha completado a tarefa. Se esse argumento for 0 (zero) ou omitido, a macro será executada independentemente do tempo decorrido desde o tempo especificado por When.
Comentários
A Microsoft Word pode manter apenas um temporizador em segundo plano definido pelo OnTime. Se você iniciar outro cronômetro antes de esgotar um cronômetro existente, o cronômetro existente será cancelado.